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, bevor Sie diese produktiv verwenden.

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

Die getScreenDetails()-Methode des Window-Interfaces gibt ein Promise zurück, das mit einer ScreenDetails-Objektinstanz erfüllt wird, die die Details aller für das Gerät des Benutzers verfügbaren Bildschirme darstellt.

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 Nutzung der Window Management API blockiert, oder wenn der Benutzer die Berechtigungsanfrage des Browsers zur Nutzung der API ausdrücklich abgelehnt hat.

Beispiele

Wenn getScreenDetails() aufgerufen wird, wird der Benutzer um Erlaubnis gebeten, Fenster auf allen seinen Anzeigen zu verwalten (der Status dieser Berechtigung kann mit Permissions.query() abgefragt werden, um window-management zu prüfen). Wenn er die Erlaubnis erteilt, enthält das resultierende ScreenDetails-Objekt Details zu allen für das System des Benutzers verfügbaren Bildschirmen.

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: Siehe Lernumgebung für mehrere Fenster für ein vollständiges Beispiel (siehe auch den Quellcode).

Spezifikationen

Specification
Window Management
# api-window-getScreenDetails-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch