Window: getScreenDetails() Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die getScreenDetails() Methode der Window Schnittstelle gibt ein Promise zurück, das mit einer ScreenDetails Objektinstanz erfüllt wird, die die Details aller Bildschirme darstellt, die dem Gerät des Benutzers zur Verfügung stehen.

Syntax

js
getScreenDetails()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einer ScreenDetails Objektinstanz erfüllt wird.

Ausnahmen

NotAllowedError DOMException

Wird ausgelöst, wenn eine window-management Permissions-Policy gesetzt ist, die die Verwendung der Window Management API blockiert, oder wenn der Benutzer der Berechtigungsanfrage des Browsers zur Nutzung der API ausdrücklich widersprochen hat.

Beispiele

Wenn getScreenDetails() aufgerufen wird, wird der Benutzer um Erlaubnis gebeten, Fenster auf allen seinen Bildschirmen zu verwalten (der Status dieser Berechtigung kann mit Permissions.query() abgefragt werden, um window-management zu überprüfen). Wenn sie die Erlaubnis erteilen, enthält das resultierende ScreenDetails Objekt Details zu allen Bildschirmen, die dem System des Benutzers zur Verfügung stehen.

Das folgende Beispiel öffnet ein Fenster in voller Größe auf jedem verfügbaren Bildschirm.

js
const screenDetails = await window.getScreenDetails();

// Open a full-size window on each screen available to the device
for (const screen of screenDetails.screens) {
  window.open(
    "https://example.com",
    "_blank",
    `left=${screen.availLeft},
    top=${screen.availTop},
    width=${screen.availWidth},
    height=${screen.availHeight}`,
  );
}

Hinweis: Sehen Sie sich das Multi-Window Lernumgebung für ein vollständiges Beispiel an (sehen Sie sich auch den Quellcode an).

Spezifikationen

Specification
Window Management
# api-window-getScreenDetails-method

Browser-Kompatibilität

Siehe auch