TouchEvent: TouchEvent() constructor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The TouchEvent() constructor creates a new TouchEvent object.

Note: If you construct a synthetic event using this constructor, that event will not be trusted, for security reasons. Only browser-generated TouchEvent objects are trusted and only trusted events trigger default actions.

Syntax

js
new TouchEvent(type)
new TouchEvent(type, options)

Parameters

type

A string with the name of the event. It is case-sensitive and browsers set it to touchstart, touchend, touchmove, touchcancel

options Optional

An object that, in addition of the properties defined in UIEvent(), can have the following properties:

touches Optional

A TouchList, defaulting to an empty one, that is a list of objects for every point of contact currently touching the surface.

targetTouches Optional

A TouchList, defaulting to an empty one, that is a list of objects for every point of contact that is touching the surface and started on the element that is the target of the current event.

changedTouches Optional

and defaulting to [], of type Touch[], that is a list of objects for every point of contact which contributed to the event.

ctrlKey Optional

A boolean value, defaulting to false, indicating if the ctrl key was simultaneously pressed.

shiftKey Optional

A boolean value, defaulting to false, indicating if the shift key was simultaneously pressed.

altKey Optional

A boolean value, defaulting to false, indicating if the alt key was simultaneously pressed.

metaKey Optional

A boolean value, defaulting to false, indicating if the meta key was simultaneously pressed.

Return value

A new TouchEvent object.

Specifications

Specification
Touch Events
# dom-touchevent-constructor

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
TouchEvent() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

See also

  • TouchEvent, the interface of the objects it constructs.