Document: createTouchList() method

{{APIRef("DOM")}}{{Deprecated_Header}}{{Non-standard_header}}

The Document.createTouchList() method creates and returns a new {{DOMxRef("TouchList")}} object.

Syntax

createTouchList(touch1)
createTouchList(touch1, touch2)
createTouchList(touch1, touch2, /* …, */ touchN)

Parameters

• touch1, …, touchN
  • : Zero or more {{DOMxRef("Touch")}} objects. Firefox also accepts an array of {{DOMxRef("Touch")}} objects.

Return value

A {{DOMxRef("TouchList")}} object containing the {{DOMxRef("Touch")}} objects specified by the touches parameter.

Examples

This example illustrates using the Document.createTouchList() method to create {{DOMxRef("TouchList")}} objects.

In following code snippet, some {{DOMxRef("Touch")}} objects are created for the target element and those touch points are then used to create some {{DOMxRef("TouchList")}} objects.

const target = document.getElementById("target");

// Create some touch points
const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

// Create an empty TouchList objects
const list0 = document.createTouchList();

// Create a TouchList with only one Touch object
const list1 = document.createTouchList(touch1);

// Create a list with two Touch objects
const list2 = document.createTouchList(touch1, touch2);

Specifications

This feature is not part of any current specification. It is no longer on track to become a standard.

Browser compatibility

{{Compat}}

See also

• Touch events
• {{DOMxRef("Touch")}}
• {{DOMxRef("TouchEvent")}}
• {{DOMxRef("TouchList")}}
• {{DOMxRef("Document.createTouch()")}}