Secure context

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

The XRReferenceSpaceEvent() constructor is used to create a new XRReferenceSpaceEvent object, which represents an event regarding the state of a WebXR reference space object, XRReferenceSpace.

Currently, only the reset event is defined using this type.


let refSpaceEvent = new XRReferenceSpaceEvent(type, eventInitDict);


A DOMString indicating the event type which has occurred. Currently, this is always reset.

An object based on the XRReferenceSpaceEventInit dictionary, containing data used to initialize the new event object. The properties of this object are:

The XRReferenceSpace from which the event originated.
An XRRigidTransform which maps the old coordinate system (from before the changes indicated by this event) to the new coordiante system.

Return value

A new XRReferenceSpaceEvent object, initialized as defined by the input parameters.


Specification Status Comment
WebXR Device API
The definition of 'XRReferenceSpaceEvent()' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser