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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support38 No43 No25 No
angle38 No43 No25 No
onchange38 No43 No25 No
type38 No43 No25 No
lock38 No43 No25 No
unlock38 No43 No25 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support3838 No4325 No5.0
angle3838 No4325 No ?
onchange3838 No4325 No ?
type3838 No4325 No ?
lock3838 No4325 No ?
unlock3838 No4325 No ?

Document Tags and Contributors

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