Document : méthode 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.
La méthode createProcessingInstruction() de l'interface Document génère un nouveau nœud ProcessingInstruction et le retourne.
Le nouveau nœud sera généralement inséré dans un document XML afin de pouvoir être utilisé, par exemple avec node.insertBefore.
Syntaxe
createProcessingInstruction(target, data)
Paramètres
piNode-
Le nœud
ProcessingInstructionrésultant. target-
Une chaîne de caractères contenant la première partie de l'instruction de traitement (c'est-à-dire
<?target … ?>). data-
Une chaîne de caractères contenant toute information que l'instruction de traitement doit porter, après la cible. Les données sont à votre discrétion, mais elles ne peuvent pas contenir
?>, car cela ferme l'instruction de traitement.
Valeur de retour
Aucune (undefined).
Exceptions
InvalidCharacterErrorDOMException-
Levée si l'une des conditions suivantes est vraie :
- La valeur de
targetn'est pas un nom XML (angl.) valide ; par exemple, elle commence par un chiffre, un tiret ou un point, ou contient des caractères autres que des caractères alphanumériques, des tirets bas (_), des tirets (-) ou des points (.). - La séquence de fermeture de l'instruction de traitement (
?>) fait partie de la valeur dedata.
- La valeur de
Exemples
const doc = new DOMParser().parseFromString("<foo />", "application/xml");
const pi = doc.createProcessingInstruction(
"xml-stylesheet",
'href="mycss.css"',
);
doc.insertBefore(pi, doc.firstChild);
console.log(new XMLSerializer().serializeToString(doc));
// Affiche : <?xml-stylesheet href="mycss.css" type="text/css"?><foo/>
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-document-createprocessinginstruction① |