ScreenOrientation

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

A ScreenOrientation instance object can be retrieved using the 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 event handler 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

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
ScreenOrientation	38	79	43	No	25	No	38	38	43	25	No	3.0
angle	38	79	43	No	25	No	38	38	43	25	No	3.0
lock	38	79	43	No	25	No	38	38	43	25	No	3.0
onchange	38	79	43	No	25	No	38	38	43	25	No	3.0
type	38	79	43	No	25	No	38	38	43	25	No	3.0
unlock	38	79	43	No	25	No	38	38	43	25	No	3.0