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

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.

Fuentes