Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The interface XRInputSourceArray
represents a live list of WebXR input sources, and is used as the return value of the XRSession
property inputSources
. Each entry is an XRInputSource
representing one input device connected to the WebXR system.
In addition to being able to access the input sources in the list using standard array notation (that is, with index numbers insize square brackets), methods are available to allow the use of iterators and the forEach()
method is also available.
Properties
The following properties are available on XRInputSourceArray
objects.
length
Read only- The number of
XRInputSource
objects in the list.
Methods
The following methods are available on XRInputSourceArray
objects. You may also use the features of the Symbol
type.
entries()
- Returns an
iterator
you can use to walk the list of key/value pairs in the list. Each item returned is an array whose first value is the index and whose second value is theXRInputSource
at that index. forEach()
- Iterates over each item in the list, in order from first to last.
keys()
- A list of the keys corresponding to the entries in the input source list.
values()
- Returns an
iterator
you can use to go through all the values in the list. Each item is a singleXRInputSource
object.
In addition to these methods, you may use array notation to access items in the list by index For example, the snippet of code below calls a function handleInput()
, passing into it the first item in the input source list, if the list isn't empty.
let sources = xrSession.inputSources;
if (sources.length > 0) {
handleInput(sources[0]);
}
Examples
Specifications
Specification | Status | Comment |
---|---|---|
WebXR Device APIThe definition of 'XRInputSourceArray' in that specification. | Working Draft | Initial definition. |
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
XRInputSourceArray
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
entries()
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
forEach()
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
keys
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
length
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
values
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
Legend
- Full support
- Full support
- No support
- No support
XRInputSourceArray by Mozilla Contributors is licensed under CC-BY-SA 2.5.