Document: createCDATASection() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
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()で代用できます）。
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-document-createcomment① |