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

CKTIS / JavaScript

window.matchMedia — tester les requêtes média

window.matchMedia teste une requête média CSS depuis JavaScript. La méthode renvoie une MediaQueryList contenant le résultat actuel dans matches et permet d’observer les changements indiquant si la requête correspond.

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);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);

window.matchMedia(query) crée une nouvelle MediaQueryList, et non une valeur booléenne. Consultez matches pour obtenir le résultat actuel ; media contient la requête sérialisée.

Transmettez une requête CSS telle que "(min-width: 768px)", sans @media. La caractéristique média width désigne la largeur de la zone d’affichage (viewport) pour les médias continus et celle de la boîte de page (page box) pour les médias paginés, comme l’impression. L’unité px désigne les pixels CSS. Cette requête ne se limite pas au type de média screen. La méthode teste une condition ; elle n’applique pas elle-même de styles.

Il s’agit d’une API de navigateur de CSSOM View, et non d’une fonctionnalité ECMAScript. Avant d’appeler window.matchMedia(query), vérifiez la condition typeof window !== "undefined" && typeof window.matchMedia === "function" ; Node 24 seul ne prouve pas que l’API est prise en charge. Ce test ne vérifie pas la présence des méthodes de gestion des écouteurs d’événements sur l’objet renvoyé.

Lisez le résultat initial dans mql.matches, où mql est la MediaQueryList renvoyée. N’enregistrez le gestionnaire avec mql.addEventListener("change", handler) que si typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Si l’une de ces méthodes manque, n’enregistrez pas le gestionnaire ; vous pouvez toujours lire matches. L’événement signale un changement de résultat, et non chaque redimensionnement ; event.matches fournit le nouveau résultat. Si vous avez enregistré le gestionnaire, appelez mql.removeEventListener("change", handler) avec la même fonction lors du nettoyage.

L’exemple utilise all et sa négation not all, ce qui rend le résultat indépendant de la taille de la fenêtre.

Exemples

const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);

Résultat

true
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