CKTIS / JavaScript
Node.firstChild — het eerste onderliggende knooppunt
Node.firstChild is een alleen-lezen eigenschap die het eerste directe onderliggende knooppunt of null retourneert. Ook tekst en opmerkingen tellen mee, dus het geretourneerde knooppunt is niet noodzakelijk een element.
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
node.firstChildNode.firstChild leest het eerste directe onderliggende knooppunt in boomvolgorde, niet het eerste element op willekeurige diepte. De eigenschap retourneert een Node-object of null als het knooppunt geen kinderen heeft. Het is een alleen-lezen eigenschap, geen methode: gebruik node.firstChild, zonder aanroep-haakjes.
Een kind kan een element, een Text-knooppunt of een Comment-knooppunt zijn. Ook tekst die uitsluitend uit witruimte bestaat, telt mee. Als je het eerste kind nodig hebt dat een element is, gebruik je firstElementChild op een Element, Document of DocumentFragment; deze eigenschap slaat tekst en opmerkingen over.
Controleer of het resultaat null is voordat je de eigenschappen ervan gebruikt. Lezen maakt geen kopie: je kunt het geretourneerde knooppunt wijzigen. Nadat kinderen zijn toegevoegd of verwijderd, geeft een nieuwe lezing van firstChild de huidige boom weer; een eerder opgeslagen verwijzing schakelt niet over naar het nieuwe eerste kind.
Het voorbeeld maakt een losstaand element, voegt witruimtetekst en een element toe en verwijdert vervolgens de kinderen. Er is een DOM-omgeving in een browser nodig. Dit is een API uit de DOM-standaard, geen functie van een bepaalde ECMAScript-editie; de Node.js-versie in een repository bewijst niet dat browser-API’s worden ondersteund.
Voorbeelden
const parent = document.createElement('div');
const text = document.createTextNode('\n ');
const element = document.createElement('span');
parent.append(text, element);
console.log(parent.firstChild === text);
console.log(parent.firstChild.nodeType === Node.TEXT_NODE);
console.log(parent.firstElementChild === element);
parent.removeChild(text);
console.log(parent.firstChild === element);
parent.removeChild(element);
console.log(parent.firstChild === null);Resultaat
true true true 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.