W3cubDocs

/Web APIs

GamepadPose: orientation property

Limited availability

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

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

The orientation read-only property of the GamepadPose interface returns the orientation of the Gamepad, as a quaternion value.

The value is a Float32Array, made up of the following values:

  • pitch — rotation around the X axis.
  • yaw — rotation around the Y axis.
  • roll — rotation around the Z axis.
  • w — the fourth dimension (usually 1).

The orientation yaw (rotation around the y axis) is relative to the initial yaw of the sensor when it was first read.

Value

A Float32Array, or null if the VR sensor is not able to provide orientation data.

Examples

TBD

Note: An orientation of { x: 0, y: 0, z: 0, w: 1 } is considered to be "forward".

Specifications

Specification
Gamepad Extensions>
# dom-gamepadpose-orientation>

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
orientation No 15–79 55 No No No 55 No No No No No

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GamepadPose/orientation