Screen.orientation

Experimental

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

The orientation read-only property of the Screen interface returns the current orientation of the screen.

Syntax

var orientation = window.screen.orientation;

Return value

An instance of ScreenOrientation representing the orientation of the screen.

Note that older, prefixed versions returned a DOMString equivalent to ScreenOrientation.type.

Example

var orientation = (screen.orientation || {}).type || screen.mozOrientation || screen.msOrientation;

if (orientation === "landscape-primary") {
  console.log("That looks good.");
} else if (orientation === "landscape-secondary") {
  console.log("Mmmh... the screen is upside down!");
} else if (orientation === "portrait-secondary" || orientation === "portrait-primary") {
  console.log("Mmmh... you should rotate your device to landscape");
} else if (orientation === undefined) {
  console.log("The orientation API isn't supported in this browser :(");
}

Specifications

Specification Status Comment
Screen Orientation API
The definition of 'orientation' in that specification.
Working Draft Initial definition

Browser compatibility

BCD tables only load in the browser

See also