Web/API/ScreenOrientation

This is an experimental technologyCheck 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.

A ScreenOrientation instance object can be retrieved using the window.screen.orientation property.

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

The EventHandler called whenever 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 APIThe 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
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
ScreenOrientation	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0
angle	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0
lock	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0
onchange	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0
type	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0
unlock	Chrome Full support 38	Edge Full support 79	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	Firefox Android Full support 43	Opera Android Full support 25	Safari iOS No support No	Samsung Internet Android Full support 3.0

Legend

Full support  

Full support

No support  

No support

ScreenOrientation by Mozilla Contributors is licensed under CC-BY-SA 2.5.