CharacterData: before() 方法

语法

before(...nodes)

参数

nodes

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

返回值

无（undefined）。

异常

HierarchyRequestError DOMException

在无法在指定位置插入新节点时抛出，即满足以下任一条件时：

• 如果插入的某个新节点会导致循环（即该节点是此 CharacterData 节点的祖先）。
• 如果某个待插入的节点不是 DocumentFragment、DocumentType、Element 或 CharacterData。
• 如果此 CharacterData 节点实际上是 Text 节点，且其父节点是 Document。
• 如果此 CharacterData 节点的父节点是 Document，而待插入的节点之一是 DocumentFragment，并且该 DocumentFragment 包含多个 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()
• DocumentType.before()
• Element.before()
• Element.append()
• Node.appendChild()
• Element.insertAdjacentElement()