CKTIS / JavaScript
window.matchMedia — Media Queries prüfen
window.matchMedia prüft eine CSS-Media-Query aus JavaScript heraus. Die Methode gibt eine MediaQueryList mit dem aktuellen Ergebnis in matches zurück und ermöglicht es, Änderungen daran zu beobachten, ob die Abfrage zutrifft.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) erstellt eine neue MediaQueryList, keinen booleschen Wert. Lies matches, um das aktuelle Ergebnis zu erhalten; media enthält die serialisierte Abfrage.
Übergib eine CSS-Abfrage, zum Beispiel "(min-width: 768px)", ohne @media. Das Medienmerkmal width bezieht sich bei kontinuierlichen Medien auf die Breite des Viewports und bei seitenbasierten Medien wie der Druckausgabe auf die Breite der Seitenbox (page box). Die Einheit px steht für CSS-Pixel. Diese Abfrage ist nicht auf den Medientyp screen beschränkt. Die Methode prüft eine Bedingung; sie wendet selbst keine Stile an.
Dies ist eine Browser-API aus CSSOM View, kein ECMAScript-Feature. Prüfe vor dem Aufruf von window.matchMedia(query) den Ausdruck typeof window !== "undefined" && typeof window.matchMedia === "function"; Node 24 allein belegt keine Unterstützung. Diese Prüfung erfasst nicht die Methoden für Ereignislistener am zurückgegebenen Objekt.
Lies das anfängliche Ergebnis aus mql.matches, wobei mql die zurückgegebene MediaQueryList ist. Registriere den Handler mit mql.addEventListener("change", handler) nur, wenn typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function" gilt. Fehlt eine der Methoden, überspringe die Registrierung; matches kannst du trotzdem lesen. Das Ereignis signalisiert ein geändertes Ergebnis, nicht jede Größenänderung; event.matches enthält das neue Ergebnis. Wenn du den Handler registriert hast, rufe beim Aufräumen mql.removeEventListener("change", handler) mit derselben Funktion auf.
Das Beispiel verwendet all und dessen Negation not all, sodass die Ausgabe unabhängig von der Fenstergröße ist.
Beispiele
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Ergebnis
true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.