W3cubDocs

/DOM

navigator.getVRDisplays

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The getVRDisplays() method of the Navigator interface returns a promise that resolves to an array of VRDisplay objects representing any available VR displays connected to the computer.

Syntax

navigator.getVRDisplays().then(function(displays) {
  // Do something with the available VR displays
});

Parameters

None.

Return value

A promise that resolves to an array of VRDisplay objects.

Examples

if(navigator.getVRDisplays) {
  console.log('WebVR 1.1 supported');
  // Then get the displays attached to the computer
  navigator.getVRDisplays().then(function(displays) {
    // If a display is available, use it to present the scene
    if(displays.length > 0) {
      vrDisplay = displays[0];
      // Now we have our VRDisplay object and can do what we want with it
    }
  });
}

Note: You can see this complete code at raw-webgl-example.

Specifications

Specification Status Comment
Unknown
The definition of 'getVRDisplays()' in that specification.
Unknown Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support No
No
Available on all platforms behind a flag, but currently only works on desktop in an experimental version of Chrome (other builds won't return any devices when Navigator.getVRDisplays() is invoked).
Yes 55
55
Currently only Windows support is enabled by default. Mac support is available in Firefox Nightly.
No No No
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes
Yes
Currently supported only by Google Daydream.
No 55 No No ?

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/navigator/getVRDisplays