Document: createProcessingInstruction()-Methode
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
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 desdata
Werts.
- Der Wert von
Beispiele
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