Document : méthode createCDATASection()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode createCDATASection() de l'interface Document crée un nouveau nœud de section CDATA et le retourne.
Syntaxe
js
createCDATASection(data)
Paramètres
data-
Une chaîne de caractères contenant les données à ajouter à la section CDATA.
Valeur de retour
Un nœud de Section CDATA.
Exemples
js
const doc = new DOMParser().parseFromString("<xml></xml>", "application/xml");
const cdata = doc.createCDATASection(
"Quelques données <CDATA>, et bien d'autres",
);
doc.querySelector("xml").appendChild(cdata);
console.log(new XMLSerializer().serializeToString(doc));
// Affiche : <xml><![CDATA[Quelques données <CDATA>, et bien d'autres]]></xml>
Notes
- Cela fonctionne uniquement avec les documents XML, pas avec les documents HTML (les documents HTML ne prennent pas en charge les sections CDATA) ; tenter cette opération sur un document HTML produira une erreur
NOT_SUPPORTED_ERR. - Une exception
NS_ERROR_DOM_INVALID_CHARACTER_ERRsera levée si vous essayez de soumettre la séquence de fermeture CDATA (]]>) dans les données ; il n'est donc pas possible d'utiliser des données fournies par l'utilisateur·ice sans échappement, sans quoi cette méthode produira cette exception (createTextNode()peut souvent être utilisée à la place).
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-document-createcomment① |