Dokumentation: Methoden createProcessingInstruction()

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() generiert 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, 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 (d.h. ).

data

Ein String, der alle Informationen enthält, die die Verarbeitungsanweisung nach dem Ziel tragen soll. Die Daten sind Ihnen überlassen, aber sie dürfen nicht ?> enthalten, da dies die Verarbeitungsanweisung schließt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn eine der folgenden Bedingungen zutrifft:

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

Beispiele

js
const doc = new DOMParser().parseFromString("", "application/xml");
const pi = doc.createProcessingInstruction(
  "xml-stylesheet",
  'href="mycss.css"',
);

doc.insertBefore(pi, doc.firstChild);

console.log(new XMLSerializer().serializeToString(doc));
// Displays:

Spezifikationen

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

Browser-Kompatibilität