WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

MediaQueryList.matches — Übereinstimmungsstatus einer Media Query

MediaQueryList.matches ist eine schreibgeschützte boolesche Eigenschaft. Sie gibt an, ob eine Media Query auf den aktuellen Zustand des Dokuments 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);
const matches = mql.matches;

MediaQueryList.matches gibt true zurück, wenn die zugehörige Media-Query-Liste auf den Zustand des Dokuments zutrifft, andernfalls false. Das Objekt erhältst du mit window.matchMedia(query). Dies ist eine schreibgeschützte Eigenschaft, keine Methode: Verwende mql.matches, nicht mql.matches().

Der Wert des Objekts kann sich ändern. Ein zuvor gespeicherter boolescher Wert wird nicht automatisch aktualisiert. Um auf Änderungen der Übereinstimmung zu reagieren, höre auf das Ereignis change; das bloße Auslesen der Eigenschaft registriert keinen Ereignis-Listener.

Das Beispiel verwendet all und not all, daher hängt die Ausgabe nicht von der Fenstergröße ab. Dies ist eine Browser-Web-API aus CSSOM View und kein ECMAScript-Feature; Node 24 belegt nicht, dass sie dort verfügbar ist.

Beispiele

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

Ergebnis

all: true
not all: 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.

Quellen