Window: método getScreenDetails()
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/es/web/api/window_management_api/index.md)
Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción.
Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.
El método getScreenDetails() de la interfaz Window devuelve una Promesa que cumple con la instancia del objeto ScreenDetails representando los detalles de todas las pantallas disponibles del dispositivo del usuario.
Sintaxis
getScreenDetails()
Parametros
Ninguno.
Valor devuelto
Una Promesa que cumple con la instancia de un objeto ScreenDetails.
Excepciones
NotAllowedErrorDOMException-
Se produce si se establece una Politica de permisos de
administración de ventanasque bloquea el uso del API de administracion de ventanas, o si el usuario ha negado explícitamente la solicitud de permiso del navegador para utilizar la API.
Ejemplos
Cuando getScreenDetails() es invocado se le pedirá permiso al usuario para administrar ventanas en todas sus pantallas (el estado de este permiso se puede verificar usando Permissions.query() para consultar window-management). Cuando se concede el permiso, el objeto ScreenDetails resultante contiene todos los detalles de todas las pantallas disponibles para el sistema del usuario.
El siguiente ejemplo abre una ventana de tamaño completo en cada pantalla disponible.
const screenDetails = await window.getScreenDetails();
// Abre una ventana de tamaño completo en cada pantalla disponible.
for (const screen of screenDetails.screens) {
window.open(
"https://example.com",
"_blank",
`left=${screen.availLeft},
top=${screen.availTop},
width=${screen.availWidth},
height=${screen.availHeight}`,
);
}
Nota: Consulta Entorno de aprendizaje de multiples ventanas para un ejemplo completo (consulta también el codigo fuente).
Especificaciones
| Specification |
|---|
| Window Management # api-window-getScreenDetails-method |
Compatibilidad con navegadores
BCD tables only load in the browser