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