CKTIS / JavaScript
Element.querySelector — eerste overeenkomende afstammeling
Element.querySelector zoekt de eerste afstammeling die 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
element.querySelector(selectors)Element.querySelector accepteert een tekenreeks selectors met een CSS-selector of een door komma’s gescheiden lijst met selectors. De methode retourneert de eerste overeenkomende afstammeling in boomvolgorde, niet in de volgorde van de selectors. Het element waarop de methode wordt aangeroepen, is zelf geen resultaat.
Bij geen overeenkomst wordt null geretourneerd. Controleer het resultaat voordat je eigenschappen benadert. Een ongeldige select syntaxis veroorzaakt een DOMException met de naam SyntaxError in plaats van null te retourneren.
Gebruik :scope > .action om een direct kind te selecteren. Zonder :scope kan de selectorovereenkomst rekening houden met voorouders buiten het aanroepende element, hoewel het resultaat een afstammeling ervan blijft. querySelectorAll() retourneert een statische lijst van alle overeenkomsten in plaats van één element.
Dit is een API uit de DOM-standaard, geen functie van de ECMAScript-taal. Het voorbeeld vereist een browseromgeving met een DOM; de aanwezigheid van Node 24 in een repository toont niet aan dat deze API wordt ondersteund.
Voorbeelden
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);Resultaat
First true true
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.