Dokument: createCDATASection() Methode

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.

Die createCDATASection()-Methode erstellt einen neuen CDATA-Abschnittsknoten und gibt diesen zurück.

Syntax

js
createCDATASection(data)

Parameter

data

Ein String, der die Daten enthält, die dem CDATA-Abschnitt hinzugefügt werden sollen.

Rückgabewert

Ein CDATA-Abschnitt-Knoten.

Beispiele

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>

Hinweise

  • Dies funktioniert nur mit XML, nicht mit HTML-Dokumenten (da HTML-Dokumente keine CDATA-Abschnitte unterstützen); ein Versuch, es auf einem HTML-Dokument anzuwenden, wird einen NOT_SUPPORTED_ERR auslösen.
  • Es wird eine NS_ERROR_DOM_INVALID_CHARACTER_ERR-Ausnahme ausgelöst, wenn versucht wird, die schließende CDATA-Sequenz (]]>) als Teil der Daten einzureichen, sodass nicht maskierte benutzerdefinierte Daten ohne diese Ausnahme nicht sicher verwendet werden können (oft kann createTextNode() stattdessen verwendet werden).

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createCDATASection

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support