Window : méthode getScreenDetails()
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
La méthode getScreenDetails() de l'interface Window retourne une promesse (Promise) qui se résout avec une instance de l'objet ScreenDetails représentant les détails de tous les écrans disponibles sur l'appareil de l'utilisateur·ice.
Syntaxe
getScreenDetails()
Paramètres
Aucun.
Valeur de retour
Une promesse (Promise) qui se résout avec une instance de l'objet ScreenDetails.
Exceptions
NotAllowedErrorDOMException-
Levée si une politique d'autorisations est définie pour bloquer l'utilisation de l'API Window Management, ou si l'utilisateur a explicitement refusé la demande de permission du navigateur pour utiliser l'API.
Exemples
Lorsque getScreenDetails() est invoquée, l'utilisateur·ice sera invité·e à autoriser la gestion des fenêtres sur tous ses écrans (le statut de cette autorisation peut être vérifié en utilisant Permissions.query() pour interroger window-management). Si l'autorisation est accordée, l'objet ScreenDetails résultant contient les détails de tous les écrans disponibles sur le système de l'utilisateur·ice.
L'exemple ci-dessous ouvre une fenêtre en plein écran sur chaque écran disponible.
const detailsEcran = await window.getScreenDetails();
// Ouvrir une fenêtre en plein écran sur chaque écran disponible
for (const ecran of detailsEcran.screens) {
window.open(
"https://exemple.com",
"_blank",
`left=${ecran.availLeft},
top=${ecran.availTop},
width=${ecran.availWidth},
height=${ecran.availHeight}`,
);
}
Note : Voir l'environnement d'apprentissage multi-fenêtres (angl.) pour un exemple complet (voir également le code source (angl.)).
Spécifications
| Specification |
|---|
| Window Management # api-window-getScreenDetails-method |