CharacterData: before() メソッド

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

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

構文

js
before(...nodes)

引数

nodes

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

例外

HierarchyRequestError DOMException

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

before() メソッドを使うと、現在のノードのデータを変更せずに、新しいノードをこの CharacterData ノードの前に挿入することができます。

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

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

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

仕様書

Specification
DOM Standard
# ref-for-dom-childnode-before①

ブラウザーの互換性

BCD tables only load in the browser

関連情報