Document: prepend() メソッド
Document.prepend()
メソッドは、一連の Node
オブジェクトまたは文字列オブジェクトを文書の最初の子の前に挿入します。文字列オブジェクトは等価な Text
ノードとして挿入されます。
このメソッドは子要素を Document
に前置します。ツリー内の任意の要素に前置するには Element.prepend()
を参照してください。
構文
js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)
引数
返値
なし (undefined
)。
例外
HierarchyRequestError
DOMException
-
ノードが階層内の指定した点に挿入できなかった場合に発生します。
例
文書にルート要素を前置
既存の HTML 文書に要素を追加しようとすると、<html>
要素が既に存在する場合は `HierarchyRequestError' DOMException
が発生するかもしれません。
js
let html = document.createElement("html");
document.prepend(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
既存の要素のない新しい文書を作成する場合、ルート HTML 要素(またはルート SVG 要素)を前置することができます。
js
let doc = new Document();
let html = document.createElement("html");
doc.prepend(html);
doc.children; // HTMLCollection [<html>]
仕様書
Specification |
---|
DOM Standard # ref-for-dom-parentnode-prepend① |
ブラウザーの互換性
BCD tables only load in the browser