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 crée un nouvel objet ProcessingInstruction et le retourne.

Syntaxe

createProcessingInstruction(target, data)

Paramètres

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 peuvent contenir n'importe quel motif de caractères, sauf qu'elles ne peuvent pas contenir ?>, car cela ferme l'instruction de traitement.

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 (?>) est incluse comme partie de la valeur de data.

La méthode createProcessingInstruction() crée une nouvelle instruction de traitement. Le nouveau nœud est généralement inséré dans un document pour accomplir une tâche avec celui-ci, en utilisant une méthode telle que node.insertBefore.

Initialement, les nœuds ProcessingInstruction ne sont pris en charge que dans les documents XML, et non dans les documents HTML. Dans les navigateurs ne prenant pas en charge cette fonctionnalité, une instruction de traitement est interprétée comme un commentaire et représentée comme un objet Comment dans l'arbre DOM.

Exemples

Utilisation simple

Cet exemple crée une instruction de traitement <xml-stylesheet> et l'ajoute en haut d'un document XML exemple.

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/>