CharacterData: метод before()

Метод before() интерфейса CharacterData вставляет набор объектов Node и строк в список дочерних элементов родителя CharacterData, сразу перед узлом CharacterData.

Строки вставляются в виде узлов Text; строка передаётся в конструктор Text().

nodes

Набор объектов Node или строк для вставки.

HierarchyRequestError DOMException

Выбрасывается, когда новые узлы не могут быть вставлены в указанную точку иерархии, то есть если выполняется одно из следующих условий:

• Если вставка одного из добавленных узлов приведёт к циклу, то есть если один из них является предком этого узла CharacterData.
• Если один из добавленных узлов не является объектом DocumentFragment, DocumentType, Element или CharacterData.
• Если этот узел CharacterData на самом деле является узлом Text, а его родитель — документом Document.
• Если родитель этого узла CharacterData является документом Document, а один из узлов для вставки — фрагментом документа DocumentFragment с более чем одним дочерним элементом Element или с дочерним узлом Text.

Метод before() позволяет вставлять новые узлы перед узлом CharacterData, не изменяя данные текущего узла.

const h1TextNode = document.querySelector("h1").firstChild;
h1TextNode.before("h1# ");

h1TextNode.parentElement.childNodes;
// NodeList [#text "h1# ", #text "CharacterData.before()"]

h1TextNode.data;
// "CharacterData.before()"

• CharacterData.appendData()
• CharacterData.after()
• DocumentType.before()
• Element.before()
• Element.append()
• Node.appendChild()
• Element.insertAdjacentElement()