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.