← 返回首页
Dokument: createCDATASection() Methode - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Dokument: createCDATASection() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

In diesem Artikel

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

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

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.