Skip to main content

userAgent

Summary​

Obtains information about the current device, operating system, and runtime environment, including information about the Web Runtime and WebSpatial Runtime.

Exposed On​

This property is available on the navigator object.

Mental Model​

If the User Agent string matches /WebSpatial\/(\S+)/, the current runtime environment has WebSpatial Runtime, and the captured version number is the npm package version of the React SDK that this runtime fully supports.

If the User Agent string matches /\sVR\s/, the current runtime environment supports WebXR.

If the User Agent string matches \swv\), the current Web Runtime is WebView.

If the User Agent string matches /WSAppShell\/(\S+)/, the current runtime environment is a Packaged WebSpatial App that includes WebSpatial Runtime. If it also matches "Macintosh", the environment is visionOS.

If the User Agent string matches /PicoWebApp\/(\S+)/, the current runtime environment is the Web App Runtime of PICO OS 6.

Read / Write Semantics​

Read-only.

Example:

const ua = navigator.userAgent.toString();

Fallback Behavior​

In environments that do not support WebSpatial, meaning there is no WebSpatial Runtime, the User Agent string does not contain a WebSpatial field.