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

CKTIS / JavaScript

document.querySelector — el primer elemento coincidente

document.querySelector(selectors) busca el primer elemento 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

document.querySelector(selectors)

document.querySelector(selectors) es un método del DOM, no forma parte de ECMAScript en sí. Acepta una cadena de selector CSS y devuelve el primer Element coincidente según el orden del árbol del documento, o null.

Comprueba si el resultado es null antes de leer sus propiedades. La sintaxis no válida de un selector provoca una DOMException llamada SyntaxError, en lugar de devolver null. En una lista de selectores separados por comas, el resultado lo determina el orden de los elementos en el árbol, no el orden de los selectores.

En cambio, querySelectorAll() devuelve una lista estática con todas las coincidencias. El ejemplo llama a querySelector() sobre el document de la página actual, por lo que las coincidencias dependen del código HTML de esa página.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.querySelector</title>
</head>
<body>
  <h1>First matching element</h1>
  <ul>
    <li class="item">First</li>
    <li class="item">Second</li>
  </ul>
  <script>
    console.log(document.querySelector('.item').textContent);
    console.log(document.querySelector('.missing') === null);
    try {
      document.querySelector('[');
    } catch (error) {
      console.log(error.name);
    }
  </script>
</body>
</html>

Resultado

First
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