База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

MediaQueryList.matches — състояние на съвпадение на медийната заявка

MediaQueryList.matches е булево свойство само за четене, което показва дали медийна заявка съвпада с текущото състояние на документа.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

MediaQueryList.matches връща true, когато свързаният списък с медийни заявки съвпада със състоянието на документа, и false в противен случай. Получи обекта чрез window.matchMedia(query). Това е свойство само за четене, а не метод: използвай mql.matches, а не mql.matches().

Стойността на обекта може да се промени. Запазена по-рано булева стойност не се актуализира автоматично. За да реагираш на промени в съвпадението, слушай събитието change; самото прочитане на свойството не регистрира слушател.

Примерът използва all и not all, затова резултатът не зависи от размера на прозореца. Това е браузърен Web API от CSSOM View, а не функция на ECMAScript; Node 24 не доказва наличността му.

Примери

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

Резултат

all: true
not all: false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници