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

CKTIS / JavaScript

Element.matches — comprobar un selector CSS

Element.matches comprueba si un elemento concreto coincide con un selector CSS. Devuelve un valor booleano, no un elemento; una sintaxis de selector no válida provoca una excepción.

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

element.matches(selectors)

element.matches(selectors) comprueba el propio element. El argumento selectors es una cadena de selector CSS o una lista de selectores separados por comas. El resultado es true si el elemento coincide, o false si no coincide.

El método no busca entre los descendientes como querySelector() ni encuentra un antepasado coincidente como closest(). No es necesario que el elemento esté unido a un documento; sin embargo, los selectores que dependen de las relaciones en el árbol tienen en cuenta su entorno real.

Un selector no válido provoca una DOMException llamada SyntaxError, en lugar de devolver false.

Esta es una API del DOM definida por DOM Standard, no una característica de ECMAScript. La presencia de Node 24 por sí sola no demuestra que esta API del navegador esté disponible.

Ejemplos

const element = document.createElement('button');
element.className = 'action';

console.log(element.matches('button.action'));
console.log(element.matches('.missing'));
console.log(element.matches('.missing, .action'));

try {
  element.matches('[');
} catch (error) {
  console.log(error.name);
}

Resultado

true
false
true
SyntaxError

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