ScreenOrientation

Experimental

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

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

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 API
The definition of 'ScreenOrientation' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser