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

CKTIS / JavaScript

CSS.supports() — откриване на поддръжка на CSS функции

CSS.supports() проверява дали браузърът съобщава за поддръжка на конкретна двойка свойство–стойност или условие за заявка на CSS функции. Методът връща булева стойност и помага при избора на резервни решения, без браузърът да се разпознава по име.

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

Синтаксис

CSS.supports(propertyName, value)
CSS.supports(supportCondition)

CSS.supports() е операция на пространството от имена CSS в Web IDL. Извиква се директно върху CSS, без да се създава екземпляр. Това е уеб API на браузъра, а не функция, дефинирана от ECMAScript; самото използване на Node 24 не доказва, че методът е наличен. Както в примера, преди извикване можете да проверите дали CSS и методът съществуват.

Формата CSS.supports(propertyName, value) приема два низа: име на CSS свойство, например "background-color" вместо "backgroundColor", и стойността, която се проверява. Връща true или false. Проверявайте конкретната стойност, защото поддръжката на дадено свойство не означава поддръжка на всичките му стойности.

Формата CSS.supports(supportCondition) приема условие, подобно на условие @supports, но без самото @supports и без блок с правила. Пример е "(color: red)"; условията могат да се комбинират с and, or и not. CSS.supports() само връща резултат — не прилага стилове. Когато условното стилизиране не изисква JavaScript, можете да използвате @supports директно в CSS.

Положителният резултат означава, че се съобщава поддръжка на проверявания синтаксис, но не гарантира правилен външен вид, липса на грешки или пълна реализация. Запазете базовите стилове и добавяйте подобрения условно. Наличието на самия метод не гарантира поддръжка на всяка проверявана функция.

Примери

if (typeof CSS === "undefined" || typeof CSS.supports !== "function") {
  console.log("CSS.supports unavailable");
} else {
  console.log(CSS.supports("color", "red"));
  console.log(CSS.supports("(color: red)"));
  console.log(CSS.supports("color", "not-a-color"));
}

Резултат

true
true
false

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

Източници