Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

CSS.supports() — detectar la compatibilidad con funciones CSS

CSS.supports() comprueba si el navegador indica que admite un par propiedad-valor concreto o una condición de consulta de funciones CSS. Devuelve un booleano y ayuda a elegir alternativas sin identificar el navegador por su nombre.

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

Sintaxis

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

CSS.supports() es una operación del espacio de nombres CSS en Web IDL. Se invoca directamente en CSS, sin crear una instancia. Es una API web del navegador, no una función definida por ECMAScript; usar Node 24 por sí solo no demuestra que esté disponible. Como hace el ejemplo, puedes comprobar que existen CSS y el método antes de llamarlo.

La forma CSS.supports(propertyName, value) acepta dos cadenas: un nombre de propiedad CSS, como "background-color" en lugar de "backgroundColor", y el valor que se quiere probar. Devuelve true o false. Comprueba el valor concreto, porque que una propiedad sea compatible no implica que lo sean todos sus valores.

La forma CSS.supports(supportCondition) acepta una condición similar a una condición @supports, pero sin el propio @supports ni un bloque de reglas. Un ejemplo es "(color: red)"; las condiciones se pueden combinar con and, or y not. CSS.supports() solo devuelve un resultado: no aplica estilos. Si el estilo condicional no requiere JavaScript, puedes usar @supports directamente en CSS.

Un resultado positivo significa que se indica compatibilidad con la sintaxis probada, pero no garantiza una apariencia correcta ni la ausencia de errores o implementaciones parciales. Mantén los estilos básicos y añade mejoras de forma condicional. Que el método esté disponible no garantiza que se admita cada función que se prueba.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes