Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

MediaQueryList.matches — wynik zapytania medialnego

MediaQueryList.matches to właściwość logiczna tylko do odczytu, wskazująca, czy zapytanie medialne pasuje do bieżącego stanu dokumentu.

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

Składnia

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

MediaQueryList.matches zwraca true, gdy powiązana lista zapytań medialnych pasuje do stanu dokumentu, a w przeciwnym razie false. Obiekt uzyskasz przez window.matchMedia(query). To właściwość tylko do odczytu, nie metoda: używaj mql.matches, nie mql.matches().

Wartość obiektu może się zmieniać. Wcześniej zapisana wartość logiczna nie aktualizuje się automatycznie. Aby reagować na zmiany dopasowania, nasłuchuj zdarzenia change; samo odczytanie właściwości nie rejestruje nasłuchiwania.

Przykład używa all i not all, więc wynik nie zależy od rozmiaru okna. Jest to przeglądarkowe Web API z CSSOM View, nie funkcja ECMAScript; Node 24 nie potwierdza jego dostępności.

Przykłady

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

Wynik

all: true
not all: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła