Document: phương thức createCDATASection()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

createCDATASection() tạo một nút CDATA section mới và trả về nó.

Cú pháp

js
createCDATASection(data)

Tham số

data

Một chuỗi chứa dữ liệu cần được thêm vào CDATA Section.

Giá trị trả về

Một nút CDATA Section.

Ví dụ

js
const doc = new DOMParser().parseFromString("<xml></xml>", "application/xml");
const cdata = doc.createCDATASection("Some <CDATA> data & then some");
doc.querySelector("xml").appendChild(cdata);
console.log(new XMLSerializer().serializeToString(doc));
// Displays: <xml><![CDATA[Some <CDATA> data & then some]]></xml>

Ghi chú

  • Phương thức này chỉ hoạt động với XML, không hoạt động với tài liệu HTML (vì tài liệu HTML không hỗ trợ CDATA sections); cố gắng sử dụng trên tài liệu HTML sẽ ném ra NOT_SUPPORTED_ERR.
  • Sẽ ném ra ngoại lệ NS_ERROR_DOM_INVALID_CHARACTER_ERR nếu cố gắng gửi chuỗi đóng CDATA (]]>) như một phần của dữ liệu, vì vậy dữ liệu do người dùng cung cấp không được escape không thể được sử dụng an toàn mà không gặp ngoại lệ này (createTextNode() thường có thể được sử dụng thay thế).

Đặc tả kỹ thuật

Specification
DOM
# ref-for-dom-document-createcomment①

Tương thích trình duyệt