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.