Document: prepend() 方法

Document.prepend() 方法将一组 Node 对象或字符串插入到文档第一个子节点之前。 字符串被插入为等效的 Text 节点。

此方法将子节点预添加到 Document。 要预添加到树中的任意元素,请参见 Element.prepend()

语法

js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)

参数

param1,…,paramN

要插入的一组 Node 对象或字符串。

返回值

无 (undefined).

异常

HierarchyRequestError DOMException

当节点无法插入到层次结构中的指定位置时抛出。

示例

将根元素预添加到文档

如果尝试将元素预添加到现有 HTML 文档,则可能会抛出 `HierarchyRequestError` DOMException,因为已经存在 <html> 元素。

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>]

规范

规范
DOM 标准
# ref-for-dom-parentnode-prepend①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参见