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 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
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.
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