W3cubDocs

/Web APIs

DeviceOrientationEvent: DeviceOrientationEvent() constructor

The DeviceOrientationEvent() constructor creates a new DeviceOrientationEvent object.

Syntax

js

new DeviceOrientationEvent(type)
new DeviceOrientationEvent(type, options)

Parameters

type

A string with the name of the event. It is case-sensitive and browsers set it to deviceorientation or deviceorientationabsolute. In the latter case, options.absolute is always true.

options Optional

An object that, in addition of the properties defined in Event(), can have the following properties:

alpha Optional

A number representing the motion of the device around the z axis, expressed in degrees with values ranging from 0 to 360. It defaults to null.

beta Optional

A number representing the motion of the device around the x axis, expressed in degrees with values ranging from -180 to 180. This represents a front to back motion of the device. It defaults to null.

gamma Optional

A number representing the motion of the device around the y axis, expressed in degrees with values ranging from -90 to 90. This represents a left to right motion of the device. It defaults to null.

absolute

A boolean value that indicates whether or not the device is providing orientation data absolutely. It defaults to false.

Return value

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
DeviceOrientationEvent 59 14 17 No 46 No 59 59 17 43 No 7.0

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