Window: método getScreenDetails()

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 (en-US) (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 (en-US) representando los detalles de todas las pantallas disponibles del dispositivo del usuario.

Sintaxis

js
getScreenDetails()

Parametros

Ninguno.

Valor devuelto

Una Promesa que cumple con la instancia de un objeto ScreenDetails (en-US).

Excepciones

NotAllowedError DOMException

Se produce si se establece una Politica de permisos (en-US) de administración de ventanas (en-US) que bloquea el uso del API de administracion de ventanas (en-US), 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() (en-US) para consultar window-management). Cuando se concede el permiso, el objeto ScreenDetails (en-US) 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.

js
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

Véase también