Document.createProcessingInstruction()
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.
createProcessingInstruction() crée un nouveau noeud d'instruction de traitement et le renvoie.
Syntaxe
Processing instruction node = document.createProcessingInstruction(target, data)
Paramètres
Processing Instruction nodeest un noeudProcessingInstruction.targetfait référence à la partie cible du noeud d'instructions de traitement (par exemple, <?target ... ?>).dataest une string (chaîne de caractères) contenant les données à ajouter aux données du noeud.
Exceptions
NOT_SUPPORTED_ERR-
Lancée si vous tentez de créer un noeud d'instructions de traitement sur un document HTML dans Gecko 9 ou antérieurs. Dans Gecko 10.0 et ultérieurs, vous pouvez utiliser cette méthode sur des documents HTML.
DOM_INVALID_CHARACTER-
Lancée si vous essayez d'ajouter une cible d'instruction de traitement invalide (ce devrait être le cas avec le nom XML et toutes les combinaisons des lettres "xml"), ou si la séquence d'instructions de traitement de fermeture ("?>") est ajoutée aux données. Les données fournies par l'utilisateur ne peuvent donc pas être utilisées en toute sécurité sans échappement ou autres moyens de faire face à de telles situations.
Exemple
var docu = new DOMParser().parseFromString("<xml></xml>", "application/xml");
var pi = docu.createProcessingInstruction(
"xml-stylesheet",
'href="mycss.css" type="text/css"',
);
docu.insertBefore(pi, docu.firstChild);
alert(new XMLSerializer().serializeToString(docu));
// Affiche: <?xml-stylesheet href="mycss.css" type="text/css"?><xml/>