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.
Properties
ScreenOrientation.typeRead only- Returns the document's current orientation type, one of "portrait-primary", "portrait-secondary", "landscape-primary", or "landscape-secondary".
ScreenOrientation.angleRead only- Returns the document's current orientation angle.
Event handlers
ScreenOrientation.onchange- Fired whenever is the
EventHandlercalled when the screen changes orientation.
Methods
ScreenOrientation.lock()- Locks the orientation of the containing document to its default orientation and returns a
Promise. ScreenOrientation.unlock()- Unlocks the orientation of the containing document from its default orientation.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Screen Orientation API The definition of 'ScreenOrientation' in that specification. |
Working Draft | Initial definition. |
Browser Compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Basic support | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support 5.0 |
angle | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android ? |
onchange | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android ? |
type | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android ? |
lock | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android ? |
unlock | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android ? |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown