W3cubDocs

/Web APIs

TouchEvent: TouchEvent() constructor

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
TouchEvent
48Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
79Edge only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
No No
35Opera only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
No
48Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
48Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
46
35Opera only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
3.2
5.0Samsung Internet only supports the following touchEventInit properties: touches, targetTouches, changedTouches.

See also

  • TouchEvent, the interface of the objects it constructs.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent