CharacterData: phương thức before()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Phương thức before() của giao diện CharacterData
chèn một tập các đối tượng Node và chuỗi
vào danh sách phần tử con của nút cha của CharacterData, ngay trước nút CharacterData.
Các chuỗi được chèn dưới dạng nút Text; chuỗi được truyền làm đối số cho hàm khởi tạo Text().
Cú pháp
js
before(...nodes)
Tham số
Giá trị trả về
Không có (undefined).
Ngoại lệ
HierarchyRequestErrorDOMException-
Được ném ra khi các nút mới không thể được chèn vào vị trí đã chỉ định trong hệ phân cấp, tức là nếu một trong các điều kiện sau xảy ra:
- Nếu việc chèn một trong các nút được thêm vào sẽ dẫn đến vòng lặp, tức là nếu một trong số chúng là tổ tiên của nút
CharacterDatanày. - Nếu một trong các nút được thêm vào không phải là
DocumentFragment,DocumentType,ElementhoặcCharacterData. - Nếu nút
CharacterDatanày thực chất là một nútText, và nút cha của nó là mộtDocument. - Nếu nút cha của nút
CharacterDatanày là mộtDocumentvà một trong các nút cần chèn là mộtDocumentFragmentcó nhiều hơn một nút conElement, hoặc có một nút conText.
- Nếu việc chèn một trong các nút được thêm vào sẽ dẫn đến vòng lặp, tức là nếu một trong số chúng là tổ tiên của nút
Ví dụ
Phương thức before() cho phép bạn chèn các nút mới trước một
nút CharacterData mà vẫn giữ nguyên dữ liệu của nút hiện tại.
js
const h1TextNode = document.querySelector("h1").firstChild;
h1TextNode.before("h1# ");
h1TextNode.parentElement.childNodes;
// NodeList [#text "h1# ", #text "CharacterData.before()"]
h1TextNode.data;
// "CharacterData.before()"
Thông số kỹ thuật
| Specification |
|---|
| DOM # ref-for-dom-childnode-before① |