Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MediaQueryList.matches — estado de coincidencia de la consulta de medios

MediaQueryList.matches es una propiedad booleana de solo lectura que indica si una consulta de medios coincide con el estado actual del documento.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const mql = window.matchMedia(query);
const matches = mql.matches;

MediaQueryList.matches devuelve true cuando la lista de consultas de medios asociada coincide con el estado del documento y false en caso contrario. Obtén el objeto con window.matchMedia(query). Es una propiedad de solo lectura, no un método: usa mql.matches, no mql.matches().

El valor del objeto puede cambiar. Un valor booleano guardado anteriormente no se actualiza automáticamente. Para reaccionar a los cambios de coincidencia, escucha el evento change; leer la propiedad por sí solo no registra un listener.

El ejemplo usa all y not all, así que el resultado no depende del tamaño de la ventana. Se trata de una API web de navegador de CSSOM View, no de una característica de ECMAScript; Node 24 no demuestra que esté disponible.

Ejemplos

const queries = ["all", "not all"];
for (const query of queries) {
  const mql = window.matchMedia(query);
  console.log(`${query}: ${mql.matches}`);
}

Resultado

all: true
not all: false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes