Dokument: createProcessingInstruction() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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.

In diesem Artikel

Syntax

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

Spezifikation

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

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Document Object Model (DOM)
Document
Konstruktor
1. Document()
Instanzeigenschaften
Statische Methoden
1. parseHTML()
2. parseHTMLUnsafe()
Instanzmethoden
Events
Vererbung
1. Node
2. EventTarget
Verwandte Seiten für DOM
Anleitungen
1. Anatomie des DOM
2. Attributreflexion
3. Auswahl und Traversierung im DOM-Baum
4. Erstellen und Aktualisieren des DOM-Baums
5. Arbeiten mit Ereignissen