Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

CSS.supports() — detetar o suporte de funcionalidades CSS

CSS.supports() verifica se o navegador indica suporte para um par propriedade-valor específico ou para uma condição de consulta de funcionalidades CSS. Devolve um booleano e ajuda a escolher alternativas sem identificar o navegador pelo nome.

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

Sintaxe

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

CSS.supports() é uma operação do espaço de nomes CSS em Web IDL. É invocada diretamente em CSS, sem criar uma instância. É uma Web API do navegador, não uma função definida por ECMAScript; utilizar Node 24, por si só, não comprova a sua disponibilidade. Tal como no exemplo, pode verificar se CSS e o método existem antes de o chamar.

A forma CSS.supports(propertyName, value) aceita duas cadeias: o nome de uma propriedade CSS, por exemplo "background-color" em vez de "backgroundColor", e o valor a testar. Devolve true ou false. Teste o valor específico, porque o suporte de uma propriedade não implica o suporte de todos os seus valores.

A forma CSS.supports(supportCondition) aceita uma condição semelhante a uma condição @supports, sem o próprio @supports nem um bloco de regras. Um exemplo é "(color: red)"; as condições podem ser combinadas com and, or e not. CSS.supports() apenas devolve um resultado — não aplica estilos. Quando o estilo condicional não exige JavaScript, pode utilizar @supports diretamente em CSS.

Um resultado positivo significa que é indicado suporte para a sintaxe testada; não garante uma apresentação correta nem a ausência de erros ou implementações parciais. Mantenha os estilos de base e acrescente melhorias de forma condicional. A disponibilidade do método, por si só, não garante suporte para todas as funcionalidades testadas.

Exemplos

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"));
}

Resultado

true
true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes