CharacterData: before() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

before() は CharacterData インターフェイスのメソッドで、一連の Node オブジェクトまたは文字列を、この CharacterData の親ノードの子リストの中、この CharacterData ノードの直前に挿入します。

文字列は Text ノードとして挿入されます。文字列は Text() コンストラクターの引数として挿入されます。

構文

before(...nodes)

引数

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()"