Firefox Tomorrow

web api instance property

XRSession: enabledFeatures property

View on MDN ↗

Limited availabilitySecure context

The XRSession interface’s read-only enabledFeatures property returns an array of features enabled (granted) for an XRSession. This contains all requiredFeatures and a subset of optionalFeatures that have been requested with requestSession().

Value

An Array of strings.

Examples

Detecting available WebXR session features

The requestSession() method allows you to request XR session features. The features can be requested either as requiredFeatures (the XRSession must support the feature), or as optionalFeatures (the XRSession may support the feature). The enabledFeatures property identifies which features are actually available in the session.

navigator.xr
  .requestSession("immersive-ar", {
    requiredFeatures: ["local", "hit-test"],
    optionalFeatures: ["anchors"],
  })
  .then((xrSession) => {
    // Log enabledFeatures
    console.log(xrSession.enabledFeatures);

    // Check if anchors can be used
    if (xrSession.enabledFeatures.includes("anchors")) {
      // Go ahead and set up anchors
    }
  });

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also