web api interface

DeviceOrientationEvent

Secure context

The DeviceOrientationEvent interface of the Device Orientation Events provides web developers with information from the physical orientation of the device running the web page.

Constructor

DeviceOrientationEvent.DeviceOrientationEvent()
- : Creates a new DeviceOrientationEvent.

Static methods

DeviceOrientationEvent.requestPermission() Experimental
- : Requests the user’s permission to access device orientation data. Returns a Promise that resolves with a string of "granted" or "denied".

Instance properties

absolute Read only
- : A boolean that indicates whether or not the device is providing orientation data absolutely.
alpha Read only
- : A number representing the motion of the device around the z axis, express in degrees with values ranging from 0 (inclusive) to 360 (exclusive).
beta Read only
- : A number representing the motion of the device around the x axis, express in degrees with values ranging from -180 (inclusive) to 180 (exclusive). This represents a front to back motion of the device.
gamma Read only
- : A number representing the motion of the device around the y axis, express in degrees with values ranging from -90 (inclusive) to 90 (exclusive). This represents a left to right motion of the device.
DeviceOrientationEvent.webkitCompassHeading Read only
- : A number represents the difference between the motion of the device around the z axis of the world system and the direction of the north, express in degrees with values ranging from 0 to 360.
DeviceOrientationEvent.webkitCompassAccuracy Read only
- : The accuracy of the compass means that the deviation is positive or negative. It’s usually 10.

Example

window.addEventListener("deviceorientation", (event) => {
  console.log(`${event.alpha} : ${event.beta} : ${event.gamma}`);
});

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.