大网数据广告活动
Web 标准与前端开发

ScreenDetails

· 52CE 我爱测

The **`ScreenDetails`** interface of the Window Management API represents the details of all the screens available to the user's device.

Window Management API

The ScreenDetails interface of the Window Management API represents the details of all the screens available to the user's device.

This information is accessed via the Window.getScreenDetails() method.

[!NOTE] ScreenDetails is a live object, meaning that it updates as the available screens change. You can therefore keep querying the same object to get updated values, rather than repeatedly calling getScreenDetails().

Instance properties

Inherits properties from its parent, EventTarget.

  • ScreenDetails.currentScreen

    • : A single ScreenDetailed object representing detailed information about the screen that the current browser window is displayed in.
  • ScreenDetails.screens

    • : An array of ScreenDetailed objects, each one representing detailed information about one specific screen available to the user's device.

      [!NOTE] screens only includes "extended" displays, not those that mirror another display.

Events

  • ScreenDetails.currentscreenchange_event
    • : Fired when the window's current screen changes in some way — for example available width or height, or orientation.
  • ScreenDetails.screenschange_event
    • : Fired when screens are connected to or disconnected from the system.

Examples

[!NOTE] See Multi-window learning environment for a full example (see the source code also).

Basic screen information access

When Window.getScreenDetails() is invoked, the user will be asked for permission to manage windows on all their displays (the status of this permission can be checked using Permissions.query() to query window-management). If the user grants permission, a ScreenDetails object is returned. This object contains details of all the screens available to the user's system.

The below example opens a full-size window on each available display.

const screenDetails = await window.getScreenDetails();

// Open a window on each screen of the device
for (const screen of screenDetails.screens) {
  openWindow(
    screen.availLeft,
    screen.availTop,
    screen.availWidth,
    screen.availHeight,
    url,
  );
}

Responding to changes in available screens

You could use the screenschange event to detect when the available screens have changed (perhaps when a screen is plugged in or unplugged), report the change, and update window arrangements to suit the new configuration:

const screenDetails = await window.getScreenDetails();

// Return the number of screens
let noOfScreens = screenDetails.screens.length;

screenDetails.addEventListener("screenschange", () => {
  // If the new number of screens is different to the old number of screens,
  // report the difference
  if (screenDetails.screens.length !== noOfScreens) {
    console.log(
      `The screen count changed from ${noOfScreens} to ${screenDetails.screens.length}`,
    );

    // Update noOfScreens value
    noOfScreens = screenDetails.screens.length;
  }

  // Open, close, or rearrange windows as needed,
  // to fit the new screen configuration
  updateWindows();
});

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。