Window: getScreenDetails()
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Window
インターフェイスの getScreenDetails()
メソッドは、ユーザーのデバイスで利用できるすべての画面の詳細を表す ScreenDetails
オブジェクトインスタンスで満たされる Promise
を返します。
構文
getScreenDetails()
引数
なし。
返値
ScreenDetails
オブジェクトインスタンスで満たされる Promise
。
例外
NotAllowedError
DOMException
-
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}`,
);
}
メモ: 完全な例については、マルチウィンドウ学習環境を参照してください(ソースコードも参照してください。)
仕様書
Specification |
---|
Window Management # api-window-getScreenDetails-method |
ブラウザーの互換性
BCD tables only load in the browser