ProcessingInstruction: ProcessingInstruction() Konstruktor

Syntax

new ProcessingInstruction(target, data)

Parameter

target

Ein String, der den Typ des Ereignisses beschreibt.

data

Ein String, der jegliche Informationen enthält, die die Verarbeitungshinweisung nach dem Ziel enthalten soll. Die Daten liegen bei Ihnen, dürfen jedoch nicht ?> enthalten, da dies die Verarbeitungsanweisung schließt.

Rückgabewert

Verarbeitungsanweisungen sind, wie der Name schon sagt, Anweisungen darüber, wie das Dokument zu verarbeiten ist. Sie können Stylesheets für XML-Dokumente, Platzhalter für HTML-Dokumente oder andere Verarbeitungsanweisungen enthalten.

Ein neues ProcessingInstruction Objekt, wenn es intern vom Browser verwendet wird.

Entwickler können den ProcessingInstruction() Konstruktor nicht direkt nutzen, um eine neue ProcessingInstruction Instanz zu erstellen, und müssen stattdessen die Methode document.createProcessingInstruction() verwenden. Der direkte Versuch, den ProcessingInstruction() Konstruktor zu verwenden, führt zu einem "illegal constructor" Fehler.

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn eines der folgenden 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 abschließende Verarbeitungsanweisungssequenz (?>) ist Teil des data Wertes.

TypeError

Wird mit der Nachricht "Illegal constructor" ausgelöst, wenn direkt verwendet.

Beispiele

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• document.createProcessingInstruction()
• Die DOM API