Window: getScreenDetails()

Limited availability

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

Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Window インターフェイスのgetScreenDetails() メソッドは、ユーザーのデバイスで利用できるすべての画面の詳細を表すScreenDetails オブジェクトインスタンスで満たされるPromise を返します。

構文

getScreenDetails()

返値

ScreenDetails オブジェクトインスタンスで満たされるPromise。

例外

NotAllowedErrorDOMException: Permissions-Policy によってWindow Management API の使用がブロックされている場合、またはユーザーが明示的にブラウザーのパーミッションリクエストを拒否した場合にスローされます。

getScreenDetails() が呼び出されると、ユーザーに対してすべてのディスプレイでウィンドウを管理する許可を求めるダイアログが表示されます（この許可の状態は、window-management をクエリーするためにPermissions.query() を使用して確認できます）。許可が与えられた場合、結果として得られるScreenDetails オブジェクトには、ユーザーのシステムで利用可能なすべてのスクリーンの詳細が含まれています。

以下の例では、利用可能な各ディスプレイ上でフルサイズのウィンドウが開きます。

const screenDetails = await window.getScreenDetails();// 端末で使用可能のすべてのスクリーンに対して、フルスクリーンのウィンドウを開きますfor (const screen of screenDetails.screens) {  window.open(    "https://example.com",    "_blank",    `left=${screen.availLeft},    top=${screen.availTop},    width=${screen.availWidth},    height=${screen.availHeight}`,  );}

メモ:完全な例については、マルチウィンドウ学習環境を参照してください(ソースコードも参照してください。)