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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.