Screen: orientation property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Theorientation read-only property of theScreen interface returns the current orientation of the screen.
In this article
Value
An instance ofScreenOrientation representing the orientation of thescreen.
Note that older, prefixed versions returned a string equivalent toScreenOrientation.type.
Examples
js
switch (screen.orientation.type) { case "landscape-primary": console.log("That looks good."); break; case "landscape-secondary": console.log("Mmm… the screen is upside down!"); break; case "portrait-secondary": case "portrait-primary": console.log("Mmm… you should rotate your device to landscape"); break; default: console.log("The orientation API isn't supported in this browser :(");}Specifications
| Specification |
|---|
| Screen Orientation> # dom-screen-orientation> |