Back to Content

XRInputSourceArray: values() method

files/en-us/web/api/xrinputsourcearray/values/index.md

latest1.5 KB
Original Source

{{APIRef("WebXR Device API")}}{{SeeCompatTable}}

The {{domxref("XRInputSourceArray")}} method values() returns a {{Glossary("JavaScript")}} iterator that can walk over the list of {{domxref("XRInputSource")}} objects contained in the array, from first to last.

Syntax

js-nolint
values()

Parameters

None.

Return value

A JavaScript iterator that can be used to walk through the list of {{domxref("XRInputSource")}} objects in the array, starting with the first entry (at index 0) and proceeding straight through the list.

Examples

This example snippet walks through each input and calls the function checkInput() with each returned value.

js
for (const source of xrSession.inputSources.values()) {
  checkInput(source);
}

Here, for...of is used to iterate over the array's contents. Each pass through the loop, source is the next {{domxref("XRInputSource")}} in the list. The loop exits once every input has been delivered to checkInput().

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Inputs and input sources
  • The {{domxref("XRInputSourceArray")}} method {{domxref("XRInputSourceArray.keys", "keys()")}}
  • The Array method values()
  • {{domxref("XRInputSource")}}