Web/API/TouchEvent/changedTouches

The changedTouches read-only property is a TouchList whose touch points (Touch objects) varies depending on the event type, as follows:

For the touchstart event, it is a list of the touch points that became active with the current event.
For the touchmove event, it is a list of the touch points that have changed since the last event.
For the touchend event, it is a list of the touch points that have been removed from the surface (that is, the set of touch points corresponding to fingers no longer touching the surface).

Syntax

var changes = touchEvent.changedTouches;

Return value

changes: A TouchList whose Touch objects include all the touch points that contributed to this touch event.

Example

This example illustrates the TouchEvent object's TouchEvent.changedTouches property. The TouchEvent.changedTouches property is a TouchList object that contains one Touch object for each touch point which contributed to the event.

In following code snippet, the touchmove event handler iterates through the changedTouches list and prints the identifier of each touch point that changed since the last event.

someElement.addEventListener('touchmove', function(e) {
   // Iterate through the list of touch points that changed
   // since the last event and print each touch point's identifier.
   for (var i=0; i < e.changedTouches.length; i++) {
     console.log("changedTouches[" + i + "].identifier = " + e.changedTouches[i].identifier);
   }   
}, false);

Specifications

Specification	Status	Comment
Touch Events – Level 2	Draft	Non-stable version.
Touch Events	Recommendation	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`changedTouches`	Chrome Full support 22	Edge Full support ≤18	Firefox Full support 52 Full support 52 No support 18 — 24	IE No support No	Opera Full support Yes	Safari No support No	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 6	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes

Legend

Full support: Full support
No support: No support

TouchEvent.changedTouches by Mozilla Contributors is licensed under CC-BY-SA 2.5.