VRDisplay.displayName

Experimental

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

The displayName read-only property of the VRDisplay interface returns a human-readable name to identify the VRDisplay.

This will generally be something like "Oculus VR HMD (HMD)" or "Oculus VR HMD (Sensor)".

Syntax

var myDisplayName = vrDisplayInstance.displayName;

Value

A DOMString containing the human-readable name of the specific VR display.

Examples

function reportDisplays() {
  navigator.getVRDisplays().then(function(displays) {
    for(var i = 0; i < displays.length; i++) {
      var cap = displays[i].capabilities;
      // cap is a VRDisplayCapabilities object
      var listItem = document.createElement('li');
      listItem.innerHTML = '<strong>Display ' + (i+1) + '</strong>'
                   + '<br>VR Display ID: ' + displays[i].displayId
                   + '<br>VR Display Name: ' + displays[i].displayName
                   + '<br>Display can present content: ' + cap.canPresent
                   + '<br>Display is separate from the computer\'s main display: ' + cap.hasExternalDisplay
                   + '<br>Display can return position info: ' + cap.hasPosition
                   + '<br>Display can return orientation info: ' + cap.hasOrientation
                   + '<br>Display max layers: ' + cap.maxLayers;
      list.appendChild(listItem);
    }
  });
}

Specifications

Specification Status Comment
WebVR 1.1
The definition of 'displayName' in that specification.
Draft Initial definition

Browser compatibility

BCD tables only load in the browser

See also