KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

document.querySelector — het eerste overeenkomende element

document.querySelector(selectors) zoekt het eerste element dat overeenkomt met een CSS-selector. De methode retourneert een element of null; een ongeldige selector veroorzaakt een uitzondering.

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

Syntax

document.querySelector(selectors)

document.querySelector(selectors) is een DOM-methode en maakt geen deel uit van ECMAScript zelf. De methode accepteert een CSS-selector als tekenreeks en retourneert het eerste overeenkomende Element in de volgorde van de documentboom, of null.

Controleer op null voordat je eigenschappen van het resultaat uitleest. Een ongeldige selectornotatie veroorzaakt een DOMException met de naam SyntaxError in plaats van null te retourneren. Bij een lijst met door komma’s gescheiden selectors bepaalt de volgorde van de elementen in de boom het resultaat, niet de volgorde van de selectors.

querySelectorAll() retourneert daarentegen een statische lijst met alle overeenkomsten. Het voorbeeld roept querySelector() aan op het document van de huidige pagina. Welke elementen overeenkomen, hangt dus af van de HTML-code van die pagina.

Voorbeelden

<!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>

Resultaat

First
true
SyntaxError

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen