Document : méthode createProcessingInstruction()

Baseline Large disponibilité

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.

Dans cet article

Syntaxe

createProcessingInstruction(target, data)

Paramètres

piNode

Le nœud ProcessingInstruction ré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

InvalidCharacterError DOMException

Levée si l'une des conditions suivantes est vraie :

La valeur de target n'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 de data.

Exemples

js
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

Spécification

DOM
# ref-for-dom-document-createprocessinginstruction①

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 9 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Référence du DOM
Document
Constructeur
1. Document()
Propriétés d'instance
Méthodes statiques
1. parseHTML()
2. parseHTMLUnsafe()
Méthodes d'instance
Évènements
Héritage
1. Node
2. EventTarget
Pages liées à DOM
Guides
1. Anatomy of the DOM
2. Réflexion des attributs
3. Sélection et parcours de l'arbre DOM
4. Construire et mettre à jour l'arbre DOM
5. Travailler avec des évènements