Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 eineexperimentelle Technologie
Überprüfen Sie dieBrowser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
DiegetScreenDetails() Methode derWindow Schnittstelle gibt einPromise zurück, das mit einerScreenDetails Objektinstanz erfüllt wird, die die Details aller Bildschirme darstellt, die dem Gerät des Benutzers zur Verfügung stehen.
Syntax
getScreenDetails()Parameter
Keine.
Rückgabewert
EinPromise, das mit einerScreenDetails Objektinstanz erfüllt wird.
Ausnahmen
NotAllowedErrorDOMExceptionWird ausgelöst, wenn eine
window-managementPermissions-Policy gesetzt ist, die die Verwendung derWindow Management API blockiert, oder wenn der Benutzer der Berechtigungsanfrage des Browsers zur Nutzung der API ausdrücklich widersprochen hat.
Beispiele
WenngetScreenDetails() aufgerufen wird, wird der Benutzer um Erlaubnis gebeten, Fenster auf allen seinen Bildschirmen zu verwalten (der Status dieser Berechtigung kann mitPermissions.query() abgefragt werden, umwindow-management zu überprüfen). Wenn sie die Erlaubnis erteilen, enthält das resultierendeScreenDetails 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.
const screenDetails = await window.getScreenDetails();// Open a full-size window on each screen available to the devicefor (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 dasMulti-Window Lernumgebung für ein vollständiges Beispiel an (sehen Sie sich auch denQuellcode an).
Spezifikationen
| Specification |
|---|
| Window Management # api-window-getScreenDetails-method |