Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti