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

CKTIS / JavaScript

Window.CSS.supports — detetar o suporte de funcionalidades CSS

Verifique em JavaScript se o navegador suporta um par específico de propriedade e valor CSS ou satisfaz uma condição de suporte antes de ativar um comportamento avançado.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

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

Window.CSS.supports designa o método supports do espaço de nomes CSS da janela do navegador. No código da página, chame window.CSS.supports() ou use CSS.supports() se nada ocultar o nome global CSS. Trata-se de uma API da Web: não faz parte do ECMAScript 2024 nem é um método estático do construtor Window.

Com dois argumentos, passe o nome da propriedade CSS e o respetivo valor em cadeias de caracteres separadas, por exemplo CSS.supports("font-size", "1rem"). Use o nome tal como se escreve em CSS (font-size, não fontSize). Com um argumento, passe apenas a condição, sem @supports, por exemplo "(font-size: 1rem)" ou "selector(:has(a))". Dentro da cadeia, combine condições com as palavras-chave CSS and, or e not, não com os operadores JavaScript &&, || e !.

true indica que o teste de suporte foi bem-sucedido nesse navegador. Um par não suportado ou uma condição mal formada devolve false. O método não aplica estilos nem verifica se um seletor corresponde a algum elemento. Mesmo true não garante uma apresentação visual sem erros.

Não pressuponha que esta API existe fora de uma página do navegador, por exemplo num worker ou num servidor. Antes da chamada, pode verificar typeof globalThis.CSS?.supports === "function". A ausência do método e um resultado false são casos distintos, mas ambos podem conduzir à mesma alternativa. Se a condição só controlar estilos, use a regra @supports diretamente no CSS.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>CSS.supports example</title>
<script>
  console.log(window.CSS.supports("color", "red"));
  console.log(window.CSS.supports("color", "123px"));
  console.log(window.CSS.supports("(color: red) and (color: blue)"));
</script>

Resultado

true
false
true

Na consola de uma página do navegador que disponibilize o método, o resultado esperado é `true`, `false` e `true`, por esta ordem. A última condição testa se ambas as declarações são suportadas, não se as duas cores são aplicadas em simultâneo.

Lições relacionadas

  • JavaScript · Lição 37 · Avançado · Versão: 4

Fontes