coderef

Lighting estimationLimited availability

The XRLightProbe and XRLightEstimate objects represent real-world environmental lighting conditions during a WebXR session.

Not yet supported in all major browsers — check the table and provide a fallback.

Browser support

DesktopChrome
1–89Not supported
90+Supportedsince Apr 13, 2021
Current: 155
Edge
12–89Not supported
90+Supportedsince Apr 15, 2021
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
18–89Not supported
90+Supportedsince Apr 13, 2021
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: getLightEstimate.

Feature detection

JS · check before using
if ("XRLightEstimate" in globalThis) {
  // XRLightEstimate is available
} else {
  // load a polyfill or use a fallback
}

Sub-features

Support for each part of the feature (11). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
XRFrame.getLightEstimate9090✕✕90✕✕
XRLightEstimate9090✕✕90✕✕
XRLightEstimate.primaryLightDirection9090✕✕90✕✕
XRLightEstimate.primaryLightIntensity9090✕✕90✕✕
XRLightEstimate.sphericalHarmonicsCoefficients9090✕✕90✕✕
XRLightProbe9090✕✕90✕✕
XRLightProbe.probeSpace9090✕✕90✕✕
XRLightProbe.reflectionchange_event9090✕✕90✕✕
XRSession.preferredReflectionFormat9090✕✕90✕✕
XRSession.requestLightProbe9090✕✕90✕✕
XRWebGLBinding.getReflectionCubeMap9090✕✕90✕✕