Document: 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 einen neuen Verarbeitungsanweisungs- Knoten und gibt ihn zurück.

Der neue Knoten wird normalerweise in ein XML-Dokument eingefügt, um damit etwas zu erreichen, wie beispielsweise 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 (z.B. <?target … ?>).

data

Ein String, der alle Informationen enthält, die die Verarbeitungsanweisung nach dem Ziel tragen soll. Die Daten können Sie frei definieren, aber sie dürfen nicht ?> enthalten, da dies die Verarbeitungsanweisung abschließt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn eines der folgenden zutrifft:

  • Der Wert von target ist kein gültiger XML-Name; zum Beispiel beginnt er mit einer Zahl, einem Bindestrich oder einem Punkt oder enthält Zeichen, die keine alphanumerischen Zeichen, Unterstriche, Bindestriche oder Punkte sind.
  • Die schließende Verarbeitungsanweisungssequenz (?>) ist Teil des data Werts.

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 Standard
# ref-for-dom-document-createprocessinginstruction①

Browser-Kompatibilität

BCD tables only load in the browser