CKTIS / JavaScript
Element.querySelector — primer descendiente coincidente
Element.querySelector busca el primer descendiente que coincide con un selector CSS. Devuelve un elemento o null; un selector no válido 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.querySelector(selectors)Element.querySelector acepta una cadena selectors que contiene un selector CSS o una lista de selectores separados por comas. Devuelve el primer descendiente coincidente según el orden del árbol, no según el orden de la lista de selectores. El elemento sobre el que se llama no es un resultado en sí mismo.
Si no hay coincidencias, devuelve null. Comprueba el resultado antes de acceder a sus propiedades. Una sintaxis de selector no válida provoca una DOMException llamada SyntaxError, en lugar de devolver null.
Usa :scope > .action para seleccionar un hijo directo. Sin :scope, la coincidencia del selector puede tener en cuenta antecesores fuera del elemento que realiza la llamada, aunque el resultado sigue siendo descendiente suyo. querySelectorAll() devuelve una lista estática de todas las coincidencias, en lugar de un único elemento.
Esta es una API del estándar DOM, no una característica del lenguaje ECMAScript. El ejemplo requiere un entorno de navegador con DOM; que Node 24 esté presente en un repositorio no demuestra que admita esta API.
Ejemplos
const root = document.createElement('section');
const first = document.createElement('button');
const second = document.createElement('button');
first.className = 'action';
second.className = 'action';
first.textContent = 'First';
second.textContent = 'Second';
root.append(first, second);
console.log(root.querySelector('.action').textContent);
console.log(root.querySelector(':scope > .action') === first);
console.log(root.querySelector('.missing') === null);Resultado
First true true
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.