CKTIS / JavaScript
Window.CSS.supports — detectar la compatibilidad con funciones de CSS
Comprueba en JavaScript si el navegador admite un par concreto de propiedad y valor CSS o cumple una condición de compatibilidad antes de activar un comportamiento mejorado.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
window.CSS.supports(propertyName, value)
window.CSS.supports(supportCondition)Window.CSS.supports designa el método supports del espacio de nombres CSS de la ventana del navegador. En el código de la página, llama a window.CSS.supports() o usa CSS.supports() si nada oculta el nombre global CSS. Es una API web, no forma parte de ECMAScript 2024 ni es un método estático del constructor Window.
Con dos argumentos, pasa el nombre de la propiedad CSS y su valor como cadenas separadas, por ejemplo CSS.supports("font-size", "1rem"). Usa el nombre tal como se escribe en CSS (font-size, no fontSize). Con un argumento, pasa solo la condición, sin @supports, como "(font-size: 1rem)" o "selector(:has(a))". Dentro de la cadena, combina condiciones con las palabras clave de CSS and, or y not, no con los operadores &&, || y ! de JavaScript.
true significa que el navegador ha superado la comprobación de compatibilidad. Un par no admitido o una condición mal formada devuelve false. El método no aplica estilos ni comprueba si un selector coincide con algún elemento. Ni siquiera true garantiza que la representación visual esté libre de errores.
No des por hecho que esta API exista fuera de una página del navegador, por ejemplo en un worker o en un servidor. Antes de llamarla, puedes comprobar typeof globalThis.CSS?.supports === "function". Que falte el método no equivale a obtener false, pero ambos casos pueden llevar a la misma alternativa. Si la condición solo controla estilos, usa la regla @supports directamente en CSS.
Ejemplos
<!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
En la consola de una página de un navegador que exponga el método, espera `true`, `false` y `true`, en ese orden. La última condición comprueba si se admiten ambas declaraciones, no si se aplican ambos colores a la vez.
Lecciones relacionadas
- JavaScript · Lección 37 · Avanzado · Versión: 4