Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

MediaQueryList.matches — état de correspondance de la requête média

MediaQueryList.matches est une propriété booléenne en lecture seule qui indique si une requête média correspond à l’état actuel du document.

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

Syntaxe

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

MediaQueryList.matches renvoie true lorsque la liste de requêtes média associée correspond à l’état du document, et false dans le cas contraire. Obtenez l’objet avec window.matchMedia(query). Il s’agit d’une propriété en lecture seule, et non d’une méthode : utilisez mql.matches, pas mql.matches().

La valeur de l’objet peut changer. Une valeur booléenne enregistrée précédemment ne se met pas à jour automatiquement. Pour réagir aux changements de correspondance, écoutez l’événement change ; lire la propriété ne suffit pas à enregistrer un écouteur.

L’exemple utilise all et not all, son résultat ne dépend donc pas de la taille de la fenêtre. Il s’agit d’une API Web de navigateur de CSSOM View, et non d’une fonctionnalité ECMAScript ; Node 24 ne permet pas d’établir sa disponibilité.

Exemples

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

Résultat

all: true
not all: false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources