XRWebGLBinding: XRWebGLBinding() constructor

Limited availability

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

See full compatibility

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The XRWebGLBinding() constructor creates and returns a new XRWebGLBinding object.

Syntax

new XRWebGLBinding(session, context)

Parameters

session: An XRSession object specifying the WebXR session which will be rendered using the WebGL context.
context: A WebGLRenderingContext or WebGL2RenderingContext identifying the WebGL drawing context to use for rendering the scene for the specified WebXR session.

Return value

A new XRWebGLBinding.

Exceptions

InvalidStateError DOMException

Thrown if the new XRWebGLBinding could not be created due to one of the following situations:

The XRSession specified by session has already been stopped.
The specified WebGL context, context, has been lost for any reason, such as a GPU switch or reset.
The specified session is immersive but the context is not WebXR compatible.

Examples

const canvasElement = document.querySelector(".output-canvas");
const gl = canvasElement.getContext("webgl");
const xrSession = await navigator.xr.requestSession("immersive-vr");
await gl.makeXRCompatible();

const glBinding = new XRWebGLBinding(xrSession, gl);

Specifications

Specification
WebXR Layers API Level 1 # dom-xrwebglbinding-xrwebglbinding

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
`XRWebGLBinding()` constructor Experimental	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 89 (Release date: 2021-03-02) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 63 (Release date: 2021-04-16) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 15 (Release date: 2021-08-13) footnote Full support	WebView Android – Full support WebView Android 89 (Release date: 2021-03-02) footnote Full 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
: Experimental. Expect behavior to change in the future.

XRWebGLBinding: XRWebGLBinding() constructor

Legend