Dokument: createProcessingInstruction() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

createProcessingInstruction() erzeugt ein neues Verarbeitungsanweisungs-Knoten und gibt es zurück.

Der neue Knoten wird normalerweise in ein XML-Dokument eingefügt, um damit etwas zu erreichen, wie zum Beispiel mit node.insertBefore.

Syntax

js
createProcessingInstruction(target, data)

Parameter

piNode

Der resultierende ProcessingInstruction-Knoten.

target

Ein String, der den ersten Teil der Verarbeitungsanweisung enthält (d.h. <?target … ?>)

data

Ein String, der alle Informationen enthält, die die Verarbeitungsanweisung transportieren soll, nach dem Ziel. Die Daten liegen bei Ihnen, aber sie können nicht ?> enthalten, da das die Verarbeitungsanweisung schließt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn eines der folgenden zutrifft:

  • Der target-Wert ist kein gültiger XML-Name; beispielsweise beginnt er mit einer Zahl, einem Bindestrich oder Punkt oder enthält andere Zeichen als alphanumerische Zeichen, Unterstriche, Bindestriche oder Punkte.
  • Die abschließende Verarbeitungsanweisungssequenz (?>) ist Teil des data-Wertes.

Beispiele

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));
// Displays: <?xml-stylesheet href="mycss.css" type="text/css"?><foo/>

Spezifikationen

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

Browser-Kompatibilität