DeviceOrientationEvent.DeviceOrientationEvent()

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The DeviceOrientationEvent constructor creates a new DeviceOrientationEvent.

Syntax

var deviceOrientationEvent = new DeviceOrientationEvent(type[, options])

Parameters

type

Either "deviceorientation" or "deviceorientationabsolute". If the later, then options.absolute should be true.
options Optional
Options are as follows:
  • alpha: A number representing the motion of the device around the z axis, express in degrees with values ranging from 0 to 360.
  • beta: A number representing the motion of the device around the x axis, express in degrees with values ranging from -180 to 180. This represents a front to back motion of the device.
  • gamma: A number representing the motion of the device around the y axis, express in degrees with values ranging from -90 to 90. This represents a left to right motion of the device.
  • absolute: A boolean that indicates whether or not the device is providing orientation data absolutely.

Specifications

Specification Status Comment
DeviceOrientation Event Specification Editor's Draft Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
DeviceOrientationEvent() constructor
ExperimentalNon-standard
Chrome Full support 59Edge Full support ≤79Firefox ? IE No support NoOpera ? Safari ? WebView Android Full support 59Chrome Android Full support 59Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android Full support 7.0

Legend

Full support
Full support
No support
No support
Compatibility unknown
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.