XRReferenceSpaceEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The WebXR Device API interface XRReferenceSpaceEvent represents an event sent to an XRReferenceSpace. Currently, the only event that uses this type is the reset event.

Constructor

XRReferenceSpaceEvent(): Returns a new XRReferenceSpaceEvent with the specified type and configuration.

Instance properties

In addition to inheriting the properties available on the parent interface, Event, XRReferenceSpaceEvent objects include the following properties:

referenceSpace Read only: An XRReferenceSpace indicating the reference space that generated the event.
transform Read only: An XRRigidTransform object indicating the position and orientation of the specified referenceSpace's native origin after the event, defined relative to the coordinate system before the event.

Instance methods

While XRReferenceSpaceEvent does not define any methods, it inherits the methods of its parent interface, Event.

Event types

reset: The reset event is sent to a reference space when its native origin is changed due to a discontinuity, recalibration, or device reset. This is an opportunity for your app to update any stored transforms, position/orientation information, or the like—or to dump any cached values based on the reference's space's origin so you can recompute them as needed.

Specifications

Specification
WebXR Device API # xrreferencespaceevent-interface

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`XRReferenceSpaceEvent`	Chrome – Full support Chrome 79 (Release date: 2019-12-10) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 66 (Release date: 2020-01-07) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 79 (Release date: 2019-12-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 57 (Release date: 2020-03-30) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 11.2 (Release date: 2020-03-22) footnote Full support	WebView Android – No support WebView Android footnote footnote See bug 40652382	WebView on iOS – No support WebView on iOS footnote No support
`XRReferenceSpaceEvent()` constructor	Chrome – Full support Chrome 79 (Release date: 2019-12-10) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 66 (Release date: 2020-01-07) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 79 (Release date: 2019-12-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 57 (Release date: 2020-03-30) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 11.2 (Release date: 2020-03-22) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support
`referenceSpace`	Chrome – Full support Chrome 79 (Release date: 2019-12-10) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 66 (Release date: 2020-01-07) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 79 (Release date: 2019-12-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 57 (Release date: 2020-03-30) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 11.2 (Release date: 2020-03-22) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support
`transform`	Chrome – Full support Chrome 79 (Release date: 2019-12-10) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 66 (Release date: 2020-01-07) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 79 (Release date: 2019-12-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 57 (Release date: 2020-03-30) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 11.2 (Release date: 2020-03-22) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.

This page was last modified on Jul 17, 2024 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.