CharacterData: before() メソッド

nodes

挿入する一連の Node または文字列です。

HierarchyRequestError DOMException

階層内の指定された位置に新しいノードを挿入できない場合，つまり以下の条件のいずれかに該当する場合に発生します。

• 追加されたノードの 1 つを挿入すると循環参照なる場合、つまり、そのノードの 1 つがこの CharacterData ノードの祖先である場合です。
• 追加されたノードのいずれかが DocumentFragment, DocumentType, Element, CharacterData のいずれでもない場合。
• この CharacterData ノードが実際には Text ノードであり、その親が Document である場合。
• この CharacterData ノードの親が Document で、挿入するノードの一つが DocumentFragment であり、その中に 1 つ以上の 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()
• Element.append()
• Node.appendChild()
• Element.insertAdjacentElement()