CKTIS / JavaScript
MediaQueryList.matches — estado de correspondência da media query
MediaQueryList.matches é uma propriedade booleana só de leitura que indica se uma media query corresponde ao estado atual do documento.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const mql = window.matchMedia(query);
const matches = mql.matches;MediaQueryList.matches devolve true quando a lista de media queries associada corresponde ao estado do documento e false caso contrário. Obtém o objeto com window.matchMedia(query). É uma propriedade só de leitura, não um método: usa mql.matches, não mql.matches().
O valor do objeto pode mudar. Um valor booleano guardado anteriormente não é atualizado automaticamente. Para reagir às alterações de correspondência, escuta o evento change; a simples leitura da propriedade não regista um listener.
O exemplo usa all e not all, por isso o resultado não depende do tamanho da janela. Trata-se de uma Web API de browser de CSSOM View, não de uma funcionalidade ECMAScript; o Node 24 não comprova a sua disponibilidade.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.