ScreenDetailed: left property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The left read-only property of the ScreenDetailed interface is a number representing the x-coordinate (left-hand edge) of the total screen area inside the OS virtual screen arrangement, relative to the multi-screen origin.

This is equal to the true left-hand edge, ignoring any OS UI element drawn at the left of the screen. Windows cannot be placed in those areas; to get the left-hand coordinate of the screen area that windows can be placed in, use ScreenDetailed.availLeft.

Note: In Firefox, a non-standard implementation of the left property is available on the Screen interface. See the Non-standard example below for usage details, and see the Screen reference page for browser support information relating to the non-standard implementation.

Value

A number.

Examples

Window Management API example

js
// Available in browsers that support the Window Management API
const screenDetails = await window.getScreenDetails();

// Return the absolute left value of the first screen
const screen1Left = screenDetails.screens[0].left;

Non-standard example

js
// Available in Firefox
// Return the absolute left value of the current screen
const screenLeft = window.screen.left;

Specifications

Specification
Window Management
# ref-for-dom-screendetailed-left

Browser compatibility

BCD tables only load in the browser

See also