Document: 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()
は、新しい CDATA セクションを生成して返します。
構文
js
createCDATASection(data)
引数
data
-
CDATA セクションに追加されるデータを含む文字列です。
返値
CDATA セクションノードです。
例
js
const docu = new DOMParser().parseFromString("<xml></xml>", "application/xml");
const cdata = docu.createCDATASection("Some <CDATA> data & then some");
docu.querySelector("xml").appendChild(cdata);
console.log(new XMLSerializer().serializeToString(docu));
// 表示結果: <xml><![CDATA[Some <CDATA> data & then some]]></xml>
メモ
- これは XML でのみ動作し、 HTML 文書では動作しません(HTML 文書は CDATA セクションに対応していません)。 HTML 文書でこれを用いた場合、
NOT_SUPPORTED_ERR
が発生します。 - 引数として渡す文字列データの一部に CDATA を閉じるシーケンス ("
]]>
") が含まれている場合、NS_ERROR_DOM_INVALID_CHARACTER_ERR
例外が発生します。エスケープされていないユーザー提供のデータは、このメソッドで例外処理を行わないと、安全に使用できません(多くの場合はcreateTextNode()
で代用できます)。
仕様書
Specification |
---|
DOM # ref-for-dom-document-createcomment① |
ブラウザーの互換性
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
createCDATASection |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.