База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Node.firstChild — първият дъщерен възел

Node.firstChild е свойство само за четене, което връща първия пряк дъщерен възел или null. То включва и текст и коментари, затова върнатият възел не е непременно елемент.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

node.firstChild

Node.firstChild прочита първия пряк дъщерен възел в реда на дървото, а не първия елемент на произволна дълбочина. Връща обект Node или null, ако възелът няма деца. Това е свойство само за четене, а не метод: използвайте node.firstChild без скоби за извикване.

Детето може да бъде елемент, възел Text или възел Comment. Брои се и текстов възел, който съдържа само знаци за празно пространство (например интервали, табулации или знаци за нов ред). Ако ви трябва първото дете, което е елемент, използвайте firstElementChild върху Element, Document или DocumentFragment; това свойство пропуска текста и коментарите.

Проверете дали резултатът е null, преди да достъпите свойствата му. Четенето не създава копие: можете да променяте върнатия възел. След добавяне или премахване на деца новото прочитане на firstChild отразява текущото дърво; препратка, запазена по-рано, не се прехвърля към новото първо дете.

Примерът създава отделен елемент, добавя текстов възел, съдържащ само знаци за празно пространство, и елемент, след което премахва децата. Необходима е DOM среда в браузър. Това е API от стандарта DOM, а не функция на конкретно издание на ECMAScript; версията на Node.js в хранилище не доказва поддръжка на API за браузър.

Примери

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);

Резултат

true
true
true
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници