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

The ScreenOrientation interface of the the Screen Orientation API provides information about the current orientation of the document.


ScreenOrientation.type Read only
Returns the document's current orientation type, one of "portrait-primary", "portrait-secondary", "landscape-primary", or "landscape-secondary".
ScreenOrientation.angle Read only
Returns the document's current orientation angle.

Event handlers

Fired whenever is the EventHandler called when the screen changes orientation.


Locks the orientation of the containing document to its default orientation and returns a Promise
Unlocks the orientation of the containing document from its default orientation.


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

Browser Compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 38 ? ? 25 ?
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support 38 38 ? ? ? 25 ?

Document Tags and Contributors

 Contributors to this page: jpmedley
 Last updated by: jpmedley,