goog.testing.events

Provided By	`goog.testing.events`

Simulate a blur event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.

Returns

boolean

The value returned by firing the blur browser event, which returns false iff 'preventDefault' was invoked.

VIEW SOURCE

Simulates an event's capturing and bubbling phases.

Parameters

`event`	`(Event\|null)`
	A simulated native event. It will be wrapped in a normalized BrowserEvent and dispatched to Closure listeners on all ancestors of its target (inclusive).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a click event on the given target. IE only supports click with the left mouse button.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_button`	`goog.events.BrowserEvent.MouseButton=`
	Mouse button; defaults to `goog.events.BrowserEvent.MouseButton.LEFT`.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mousedown, mouseup, and then click on the given event target, with the left mouse button.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_button`	`goog.events.BrowserEvent.MouseButton=`
	Mouse button; defaults to `goog.events.BrowserEvent.MouseButton.LEFT`.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulates a contextmenu event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mousedown, contextmenu, and the mouseup on the given event target, with the right mouse button.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulates a double-click event on the given target. Always double-clicks with the left mouse button since no browser supports double-clicking with any other buttons.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates the sequence of events fired by the browser when the user double- clicks the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulate a focus event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.

Returns

boolean

The value returned by firing the focus browser event, which returns false iff 'preventDefault' was invoked.

VIEW SOURCE

Simulate a focus-in event on the given target.

Parameters

`target`	`EventTarget`
	The target for the event.

Returns

boolean

The value returned by firing the focus-in browser event, which returns false iff 'preventDefault' was invoked.

VIEW SOURCE

Simulates a complete keystroke (keydown, keypress, and keyup). Note that if preventDefault is called on the keydown, the keypress will not fire.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`keyOrKeyCode`	`(string\|number)`
	The key value or keycode of the key pressed.
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulates a mousedown event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_button`	`goog.events.BrowserEvent.MouseButton=`
	Mouse button; defaults to `goog.events.BrowserEvent.MouseButton.LEFT`.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mouseenter event on the given target.

Parameters

`target`	`EventTarget`
	The target for the event.
`relatedTarget`	`(EventTarget\|null)`
	The related target for the event (e.g., the node that the mouse is being moved out of).
`opt_coords`	`goog.math.Coordinate=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mouseleave event on the given target.

Parameters

`target`	`EventTarget`
	The target for the event.
`relatedTarget`	`(EventTarget\|null)`
	The related target for the event (e.g., the node that the mouse is being moved into).
`opt_coords`	`goog.math.Coordinate=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mousemove event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mouseout event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`relatedTarget`	`(EventTarget\|null)`
	The related target for the event (e.g., the node that the mouse is being moved into).
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mouseover event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`relatedTarget`	`(EventTarget\|null)`
	The related target for the event (e.g., the node that the mouse is being moved out of).
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a mouseup event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_button`	`goog.events.BrowserEvent.MouseButton=`
	Mouse button; defaults to `goog.events.BrowserEvent.MouseButton.LEFT`.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Mouse position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a complete keystroke (keydown, keypress, and keyup) when typing a non-ASCII character. Same as fireKeySequence, the keypress will not fire if preventDefault is called on the keydown.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`keyOrKeyCode`	`(string\|number)`
	The key value or keycode of the keydown and keyup events.
`keyPressKeyOrKeyCode`	`(string\|number)`
	The key value or keycode of the keypress event.
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulates a popstate event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`state`	`(Object\|null)`
	History state object.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a touchend event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Touch position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a touchmove event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Touch position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Simulates a simple touch sequence on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Touch position. Defaults to event target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the sequence: false if preventDefault() was called on any of the events, true otherwise.

VIEW SOURCE

Simulates a touchstart event on the given target.

Parameters

`target`	`(EventTarget\|null)`
	The target for the event.
`opt_coords`	`(goog.math.Coordinate\|null)=`
	Touch position. Defaults to event's target's position (if available), otherwise (0, 0).
`opt_eventProperties`	`(Object\|null)=`
	Event properties to be mixed into the BrowserEvent.

Returns

boolean

The returnValue of the event: false if preventDefault() was called on it, true otherwise.

VIEW SOURCE

Mixins a listenable into the given object. This turns the object into a goog.events.Listenable. This is useful, for example, when you need to mock a implementation of listenable and still want it to work with goog.events.

Parameters

`obj`	`Object`
	The object to mixin into.

VIEW SOURCE

goog.testing.events

Functions

fireBlurEvent( `target` ) `→` `boolean`

fireBrowserEvent( `event` ) `→` `boolean`

fireClickEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireClickSequence( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireContextMenuEvent( `target`, `opt_coords` ) `→` `boolean`

fireContextMenuSequence( `target`, `opt_coords` ) `→` `boolean`

fireDoubleClickEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireDoubleClickSequence( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireFocusEvent( `target` ) `→` `boolean`

fireFocusInEvent( `target` ) `→` `boolean`

fireKeySequence( `target`, `keyOrKeyCode`, `opt_eventProperties` ) `→` `boolean`

fireMouseDownEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireMouseEnterEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseLeaveEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseMoveEvent( `target`, `opt_coords` ) `→` `boolean`

fireMouseOutEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseOverEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseUpEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireNonAsciiKeySequence( `target`, `keyOrKeyCode`, `keyPressKeyOrKeyCode`, `opt_eventProperties` ) `→` `boolean`

firePopStateEvent( `target`, `state` ) `→` `boolean`

fireTouchEndEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchMoveEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchSequence( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchStartEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

mixinListenable( `obj` ) `→` `void`

Classes

goog.testing.events

Functions

fireBlurEvent( target ) → boolean

fireBrowserEvent( event ) → boolean

fireClickEvent( target, opt_button, opt_coords, opt_eventProperties ) → boolean

fireClickSequence( target, opt_button, opt_coords, opt_eventProperties ) → boolean

fireContextMenuEvent( target, opt_coords ) → boolean

fireContextMenuSequence( target, opt_coords ) → boolean

fireDoubleClickEvent( target, opt_coords, opt_eventProperties ) → boolean

fireDoubleClickSequence( target, opt_coords, opt_eventProperties ) → boolean

fireFocusEvent( target ) → boolean

fireFocusInEvent( target ) → boolean

fireKeySequence( target, keyOrKeyCode, opt_eventProperties ) → boolean

fireMouseDownEvent( target, opt_button, opt_coords, opt_eventProperties ) → boolean

fireMouseEnterEvent( target, relatedTarget, opt_coords ) → boolean

fireMouseLeaveEvent( target, relatedTarget, opt_coords ) → boolean

fireMouseMoveEvent( target, opt_coords ) → boolean

fireMouseOutEvent( target, relatedTarget, opt_coords ) → boolean

fireMouseOverEvent( target, relatedTarget, opt_coords ) → boolean

fireMouseUpEvent( target, opt_button, opt_coords, opt_eventProperties ) → boolean

fireNonAsciiKeySequence( target, keyOrKeyCode, keyPressKeyOrKeyCode, opt_eventProperties ) → boolean

firePopStateEvent( target, state ) → boolean

fireTouchEndEvent( target, opt_coords, opt_eventProperties ) → boolean

fireTouchMoveEvent( target, opt_coords, opt_eventProperties ) → boolean

fireTouchSequence( target, opt_coords, opt_eventProperties ) → boolean

fireTouchStartEvent( target, opt_coords, opt_eventProperties ) → boolean

mixinListenable( obj ) → void

Classes

fireBlurEvent( `target` ) `→` `boolean`

fireBrowserEvent( `event` ) `→` `boolean`

fireClickEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireClickSequence( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireContextMenuEvent( `target`, `opt_coords` ) `→` `boolean`

fireContextMenuSequence( `target`, `opt_coords` ) `→` `boolean`

fireDoubleClickEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireDoubleClickSequence( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireFocusEvent( `target` ) `→` `boolean`

fireFocusInEvent( `target` ) `→` `boolean`

fireKeySequence( `target`, `keyOrKeyCode`, `opt_eventProperties` ) `→` `boolean`

fireMouseDownEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireMouseEnterEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseLeaveEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseMoveEvent( `target`, `opt_coords` ) `→` `boolean`

fireMouseOutEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseOverEvent( `target`, `relatedTarget`, `opt_coords` ) `→` `boolean`

fireMouseUpEvent( `target`, `opt_button`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireNonAsciiKeySequence( `target`, `keyOrKeyCode`, `keyPressKeyOrKeyCode`, `opt_eventProperties` ) `→` `boolean`

firePopStateEvent( `target`, `state` ) `→` `boolean`

fireTouchEndEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchMoveEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchSequence( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

fireTouchStartEvent( `target`, `opt_coords`, `opt_eventProperties` ) `→` `boolean`

mixinListenable( `obj` ) `→` `void`