Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

CSS.supports() — rilevare il supporto delle funzionalità CSS

CSS.supports() verifica se il browser segnala il supporto per una specifica coppia proprietà-valore o per una condizione di interrogazione delle funzionalità CSS. Restituisce un booleano e aiuta a scegliere soluzioni alternative senza identificare il browser dal nome.

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

Sintassi

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

CSS.supports() è un’operazione dello spazio dei nomi CSS in Web IDL. Si invoca direttamente su CSS, senza creare un’istanza. È una Web API del browser, non una funzione definita da ECMAScript; usare Node 24, da solo, non ne dimostra la disponibilità. Come nell’esempio, prima di chiamarlo puoi verificare che CSS e il metodo esistano.

La forma CSS.supports(propertyName, value) accetta due stringhe: il nome di una proprietà CSS, per esempio "background-color" anziché "backgroundColor", e il valore da verificare. Restituisce true o false. Verifica il valore specifico, perché il supporto di una proprietà non implica quello di tutti i suoi valori.

La forma CSS.supports(supportCondition) accetta una condizione simile a una condizione @supports, senza @supports stesso né un blocco di regole. Un esempio è "(color: red)"; le condizioni si possono combinare con and, or e not. CSS.supports() restituisce soltanto un risultato: non applica stili. Se lo stile condizionale non richiede JavaScript, puoi usare direttamente @supports in CSS.

Un risultato positivo indica il supporto dichiarato per la sintassi verificata, ma non garantisce un aspetto corretto né l’assenza di bug o implementazioni parziali. Mantieni gli stili di base e aggiungi miglioramenti in modo condizionale. La disponibilità del metodo non garantisce il supporto di ogni funzionalità verificata.

Esempi

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

Risultato

true
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti