CKTIS / JavaScript
MediaQueryList.matches — stato di corrispondenza della media query
MediaQueryList.matches è una proprietà booleana di sola lettura che indica se una media query corrisponde allo stato corrente del documento.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const mql = window.matchMedia(query);
const matches = mql.matches;MediaQueryList.matches restituisce true quando la lista di media query associata corrisponde allo stato del documento, e false altrimenti. Ottieni l’oggetto con window.matchMedia(query). È una proprietà di sola lettura, non un metodo: usa mql.matches, non mql.matches().
Il valore dell’oggetto può cambiare. Un valore booleano salvato in precedenza non si aggiorna automaticamente. Per reagire ai cambiamenti di corrispondenza, ascolta l’evento change; la sola lettura della proprietà non registra un listener.
L’esempio usa all e not all, quindi il risultato non dipende dalle dimensioni della finestra. Si tratta di una Web API del browser di CSSOM View, non di una funzionalità ECMAScript; Node 24 non ne stabilisce la disponibilità.
Esempi
const queries = ["all", "not all"];
for (const query of queries) {
const mql = window.matchMedia(query);
console.log(`${query}: ${mql.matches}`);
}Risultato
all: true not all: false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.