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

CKTIS / JavaScript

Проверка и промяна на DOM възли чрез `Node`

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

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

node.contains(otherNode)
node.normalize()
node.parentNode
node.firstChild
parent.insertBefore(newNode, referenceNode)
parent.insertBefore(newNode, null)

Node е интерфейс на уеб DOM, а не част от ECMAScript 2024. Тези методи и свойства се използват върху обекти, представляващи възли. В браузър примерът използва вградения DOM, а в Node.js — опростен модел на показаните елементи и текстови възли.

node.contains(otherNode) връща true, ако otherNode е същият възел или негов потомък на произволна дълбочина. За null връща false. Проверката остава в рамките на същото дърво от възли: работи и в отделено поддърво и не преминава от хоста към неговото shadow дърво.

parentNode и firstChild са свойства само за четене. Първото връща непосредствения родител или null; за разлика от parentElement, то може да върне Document или DocumentFragment. Второто връща първото пряко дете или null. Това дете може да е коментар или текстов възел с празни знаци. За първото дете, което е елемент, използвай firstElementChild.

parent.insertBefore(newNode, referenceNode) вмъква възела пред посоченото пряко дете. Подай втория аргумент изрично: null означава вмъкване в края. Затова parent.firstChild позволява вмъкване в началото дори когато родителят няма деца. Методът премества съществуващ възел, вместо да го копира, и връща newNode. При DocumentFragment премества децата му и връща изпразнения фрагмент. Ако референтният възел не е пряко дете, възниква NotFoundError; невалидна йерархия, например цикъл, води до HierarchyRequestError.

node.normalize() променя самото поддърво: премахва празните обикновени текстови възли и слива съседните възли от този вид, като запазва реда на текста. Не премахва празни знаци и връща undefined. Запазена референция към премахнат възел продължава да сочи към същия обект, но той вече няма родител. Това не е нормализацията на Unicode, която извършва String.prototype.normalize().

Примери

{
  // Node.js has no document. This fallback models only the element and
  // text-node behavior used below; in a browser, use the native DOM.
  class ExampleNode {
    parentNode = null;
    childNodes = [];

    constructor(data = null) {
      this.data = data;
    }

    get firstChild() {
      return this.childNodes[0] ?? null;
    }

    contains(node) {
      for (let current = node; current !== null; current = current.parentNode) {
        if (current === this) return true;
      }
      return false;
    }

    #detach() {
      const parent = this.parentNode;
      if (parent !== null) {
        parent.childNodes.splice(parent.childNodes.indexOf(this), 1);
        this.parentNode = null;
      }
    }

    insertBefore(node, reference) {
      if (node === reference) return node;
      node.#detach();
      const index = reference === null
        ? this.childNodes.length
        : this.childNodes.indexOf(reference);
      this.childNodes.splice(index, 0, node);
      node.parentNode = this;
      return node;
    }

    normalize() {
      let previousText = null;
      for (const child of [...this.childNodes]) {
        if (child.data === null) {
          child.normalize();
          previousText = null;
        } else if (child.data === "") {
          child.#detach();
        } else if (previousText !== null) {
          previousText.data += child.data;
          child.#detach();
        } else {
          previousText = child;
        }
      }
    }
  }

  const doc = globalThis.document ?? {
    createElement: () => new ExampleNode(),
    createTextNode: (data) => new ExampleNode(data)
  };
  const root = doc.createElement("div");
  const a = doc.createTextNode("A");
  const b = doc.createTextNode("B");
  const empty = doc.createTextNode("");

  root.insertBefore(a, root.firstChild);
  root.insertBefore(b, null);
  root.insertBefore(empty, root.firstChild);
  console.log(JSON.stringify([
    root.contains(root), root.contains(null), root.contains(b),
    b.parentNode === root, root.firstChild === empty, root.childNodes.length
  ]));

  root.normalize();
  console.log(JSON.stringify([
    root.firstChild === a, root.firstChild.data, root.contains(b),
    b.parentNode === null, root.childNodes.length
  ]));
}

Резултат

[true,false,true,true,true,3]
[true,"AB",false,true,1]

Изпълни кода в конзолата на браузър или в Node.js. `root` остава извън документа. След нормализирането `a` съдържа `AB` и е единственото дете, а `b` е отделен.

Свързани уроци

  • JavaScript · Урок 33 · Средно · Версия: 3

Източници