XRSession.visibilityState

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

The read-only visibilityState property of the XRSession interface is a string indicating whether the WebXR content is currently visible to the user, and if it is, whether it's the primary focus.

Every time the visibility state changes, a visibilitychange event is fired on the XRSession object.

Syntax

visibilityState = xrSession.visibilityState;

Value

A DOMString containing one of the values defined in the enumerated type XRVisibilityState; this string indicates whether or not the XR content is visible to the user and if it is, whether or not it's currently the primary focus.

The possible values of visibilityState are:

hidden
The virtual scene generated by the XRSession is not currently visible to the user, so its requestAnimationFrame() callbacks are not being executed until thevisibilityState changes. Input controllers are not being handled for the session.
visible
The virtual scene rendered by the XRSession is currently visible to the user and is the primary focus of the user's attention. To that end, the session's requestAnimationFrame() callbacks are being processed at the XR device's native refresh rate and input controllers are being processed as normal.
visible-blurred
While the virtual scene rendered by the XRSession may currently be visible to the user, it is not the user's primary focus at the moment; it's also possible the session is not currently visible at all. In order to optimize resource utilization, the user agent may be handling the session's requestAnimationFrame() callbacks at a throttled rate. Inut controllers are not being processed for the session.

Specifications

Specification Status Comment
WebXR Device API
The definition of 'XRSession.visibilityState' in that specification.
Working Draft Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
visibilityStateChrome Full support 79Edge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android Full support 79Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support

See also