Screen: unlockOrientation() method

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

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

Warning: This feature is deprecated and should be avoided. Use the ScreenOrientation.unlock() method instead.

Note: This method only works for installed Web apps or for Web pages in fullscreen mode.

Syntax

js
unlockOrientation()

Parameters

None.

Return value

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

Examples

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

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

Specifications

This feature is not part of any specification. It is no longer on track to becoming a standard.

Use ScreenOrientation.unlock() instead.

Browser compatibility

See also