TouchEvent()

The TouchEvent() constructor creates a new TouchEvent.

Syntax

 event = new TouchEvent(typeArg, touchEventInit);

Values

typeArg
Is a DOMString representing the name of the event.
touchEventInit Optional
Is a TouchEventInit dictionary, having the following fields:
  • "touches", optional and defaulting to [], of type Touch[], that is a list of objects for every point of contact currently touching the surface.
  • "targetTouches", optional and defaulting to [], of type Touch[], 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 and defaulting to false, of type Boolean, that indicates if the ctrl key was simultaneously pressed.
  • "shiftKey", optional and defaulting to false, of type Boolean, that indicates if the shift key was simultaneously pressed.
  • "altKey", optional and defaulting to false, of type Boolean, that indicates if the alt key was simultaneously pressed.
  • "metaKey", optional and defaulting to false, of type Boolean, that indicates if the meta key was simultaneously pressed.

The TouchEventInit dictionary also accepts fields from UIEventInit and from EventInit dictionaries.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
TouchEvent() constructorChrome Full support 48
Notes
Full support 48
Notes
Notes Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
Edge Full support ≤79
Notes
Full support ≤79
Notes
Notes Edge only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
Firefox ? IE No support NoOpera Full support YesSafari No support NoWebView Android Full support 48
Notes
Full support 48
Notes
Notes Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
Chrome Android Full support 48
Notes
Full support 48
Notes
Notes Chrome only supports the following touchEventInit properties: touches, targetTouches, changedTouches.
Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support 3.2Samsung Internet Android Full support 5.0
Notes
Full support 5.0
Notes
Notes Samsung Internet only supports the following touchEventInit properties: touches, targetTouches, changedTouches.

Legend

Full support
Full support
No support
No support
Compatibility unknown
Compatibility unknown
See implementation notes.
See implementation notes.

See also

  • TouchEvent, the interface of the objects it constructs.