TouchEvent: changedTouches property
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).
Value
A TouchList whose Touch objects include all the touch points that contributed to this touch event.
Examples
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",
(e) => {
for (let i = 0; i < e.changedTouches.length; i++) {
console.log(
`changedTouches[${i}].identifier = ${e.changedTouches[i].identifier}`,
);
}
},
false,
);
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 |
changedTouches |
22 |
79 |
52
18–24Removed in bug 888304 due to web compatibility issues.
|
No |
15 |
No |
4.4 |
25 |
6 |
14 |
3.2 |
1.5 |