GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • MDN
  • HTML: Markup language
  • Elements
  • Global attributes
  • Attributes
  • See all…
  • Responsive images
  • HTML cheatsheet
  • Date & time formats
  • See all…
  • SVG
  • MathML
  • XML
  • CSS: Styling language

This view

  • Original page
  • New address

GeezerVison is showing developer.mozilla.org — Window: deviceorientation event - Web APIs | MDN

Window: deviceorientation event

Baseline
Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2023.

  • See full compatibility
  • Learn more

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The deviceorientation event is fired when fresh data is available from an orientation sensor about the current orientation of the device as compared to the Earth coordinate frame. This data is gathered from a magnetometer inside the device.

See Orientation and motion data explained for details.

This event is not cancelable and does not bubble.

Syntax

Use the event name in addEventListener():

js
addEventListener("deviceorientation", (event) => { })

Alternatively, assign to the event handler property of the interface:

js
ondeviceorientation = (event) => { }

Event type

A DeviceOrientationEvent. Inherits from Event.

Examples

js
if (window.DeviceOrientationEvent) {
  window.addEventListener(
    "deviceorientation",
    (event) => {
      const rotateDegrees = event.alpha; // alpha: rotation around z-axis
      const leftToRight = event.gamma; // gamma: left to right
      const frontToBack = event.beta; // beta: front back motion

      handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
    },
    true,
  );
}

function handleOrientationEvent(frontToBack, leftToRight, rotateDegrees) {
  // do something amazing
}

Specifications

Specification
Device Orientation and Motion
# deviceorientation
Device Orientation and Motion
# dom-window-ondeviceorientation

Browser compatibility

See also

  • devicemotion
  • Detecting device orientation
  • Orientation and motion data explained

Help improve MDN

Learn how to contribute

This page was last modified on Oct 26, 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.