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.