Permissions-Policy: xr-spatial-tracking directive

{{SeeCompatTable}} 

The HTTP {{HTTPHeader("Permissions-Policy")}}  header xr-spatial-tracking directive controls whether the current document is allowed to use the WebXR Device API.

Specifically, where a defined policy blocks usage of this feature:

• {{DOMxRef("XRSystem/isSessionSupported","navigator.xr.isSessionSupported()")}}  and {{DOMxRef("XRSystem/requestSession","navigator.xr.requestSession()")}}  calls will return a {{jsxref("Promise")}}  that rejects with a {{domxref("DOMException")}}  of type SecurityError.

• {{domxref("XRSystem/devicechange_event", "devicechange")}}  events are not fired on the {{DOMxRef("Navigator.xr","navigator.xr")}}  object.

Syntax

Permissions-Policy: xr-spatial-tracking=<allowlist>;

• <allowlist>
  • : A list of origins for which permission is granted to use the feature. See Permissions-Policy > Syntax for more details.

Default policy

The default allowlist for xr-spatial-tracking is self.

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• WebXR Device API
• {{DOMxRef("XRSystem/requestSession","navigator.xr.requestSession()")}} , and {{DOMxRef("XRSystem/isSessionSupported","navigator.xr.isSessionSupported()")}}  and {{domxref("XRSystem/devicechange_event", "devicechange")}}  event on {{DOMxRef("Navigator.xr","navigator.xr")}} 
• {{HTTPHeader("Permissions-Policy")}}  header
• Permissions Policy