Web/API/Screen/unlockOrientation

DeprecatedThis feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The Screen.unlockOrientation() method removes all the previous screen locks set by the page/app. The ScreenOrientation.unlock() method should be used instead.

Note: This method only works for installed Web apps or for Web pages in full-screen mode.

Syntax

var unlocked = window.screen.unlockOrientation();

Return value

Returns true if the orientation was successfully unlocked or false if the orientation couldn't be unlocked.

Example

var unlockOrientation = screen.unlockOrientation || screen.mozUnlockOrientation || screen.msUnlockOrientation || (screen.orientation && screen.orientation.unlock);

if (unlockOrientation()) {
  // orientation was unlocked
} else {
  // orientation unlock failed
}

Specifications

Specification	Status	Comment
Screen Orientation APIThe definition of 'lockOrientation()' in that specification.	Working Draft	Initial definition (Not present in the draft anymore)

Browser compatibility

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
`unlockOrientation`	Chrome Full support 38	Edge Full support 12 Prefixed' Full support 12 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Firefox Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	IE Full support 11 Prefixed' Full support 11 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Opera Full support Yes	Safari No support No	WebView Android Full support 38	Chrome Android Full support 38	Firefox Android Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support 3.0

Legend

Full support: Full support
No support: No support
Requires a vendor prefix or different name for use.': Requires a vendor prefix or different name for use.