文件:createCDATASection() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

createCDATASection() 建立一個新的 CDATA 部分節點,並返回它。

語法

js
createCDATASection(data)

引數

data

包含要新增到 CDATA 部分的字串資料。

返回值

一個 CDATA Section 節點。

示例

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>

注意

  • 這隻對 XML 文件有效,而不是 HTML 文件(因為 HTML 文件不支援 CDATA 部分);在 HTML 文件上嘗試此操作將丟擲 NOT_SUPPORTED_ERR
  • 如果嘗試將 CDATA 的結束序列 (]]>) 作為資料的一部分提交,則會丟擲 NS_ERROR_DOM_INVALID_CHARACTER_ERR 異常,因此未經轉義的使用者提供的資料無法安全地使用,除非此方法捕獲此異常(通常可以使用 createTextNode() 代替)。

規範

規範
DOM
# ref-for-dom-document-createcomment①

瀏覽器相容性