document.createComment

Résumé

createComment() crée et retourne un nouveau noeud de type commentaire.

Syntaxe

CommentNode = document.createComment(data) 

Parameters

data

Une chaîne de caractères représentant le contenu du commentaire.

Exemple

var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml");
var comment = docu.createComment('Voici un commentaire pas très bien caché');

docu.getElementsByTagName('xml')[0].appendChild(comment);

alert(new XMLSerializer().serializeToString(docu));
// Affiche: <xml><!--Voici un commentaire pas très bien caché--></xml>

Notes

• Cette méthode lancera une exception NS_ERROR_DOM_INVALID_CHARACTER_ERR si l'on tente d'intégrer la séquence "--" dans la chaîne de caractères passée en argument ; par conséquent, si la chaîne provient d'une saisie utilisateur, il est préférable de l'échapper ou d'intercepter l'exception.

Specification

• createComment