CKTIS / JavaScript
Window.CSS.supports — rilevare il supporto delle funzionalità CSS
Verifica in JavaScript se il browser supporta una specifica coppia proprietà-valore CSS o soddisfa una condizione di supporto, prima di attivare un comportamento avanzato.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
window.CSS.supports(propertyName, value)
window.CSS.supports(supportCondition)Window.CSS.supports indica il metodo supports dello spazio dei nomi CSS della finestra del browser. Nel codice di una pagina, chiama window.CSS.supports() oppure usa CSS.supports() se nulla nasconde il nome globale CSS. È un’API Web: non fa parte di ECMAScript 2024 e non è un metodo statico del costruttore Window.
Con due argomenti, passa il nome della proprietà CSS e il suo valore come stringhe separate, ad esempio CSS.supports("font-size", "1rem"). Usa il nome CSS (font-size, non fontSize). Con un solo argomento, passa soltanto la condizione, senza @supports, ad esempio "(font-size: 1rem)" o "selector(:has(a))". Nella stringa, combina le condizioni con le parole chiave CSS and, or e not, non con gli operatori JavaScript &&, || e !.
true indica che il test di supporto è riuscito in quel browser. Una coppia non supportata o una condizione malformata restituisce false. Il metodo non applica stili e non controlla se un selettore corrisponde a un elemento. Neppure true garantisce una resa grafica priva di errori.
Non dare per scontato che l’API esista al di fuori di una pagina del browser, ad esempio in un worker o su un server. Prima della chiamata puoi verificare typeof globalThis.CSS?.supports === "function". L’assenza del metodo e un risultato false sono casi distinti, ma possono portare alla stessa soluzione di riserva. Se la condizione controlla solo gli stili, usa direttamente la regola @supports in CSS.
Esempi
<!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>Risultato
true false true
Nella console di una pagina del browser che espone il metodo, il risultato atteso è `true`, `false`, `true`, in quest’ordine. L’ultima condizione verifica il supporto di entrambe le dichiarazioni, non che entrambi i colori vengano applicati contemporaneamente.
Lezioni correlate
- JavaScript · Lezione 37 · Avanzato · Versione: 4