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.
Please take two minutes to fill out our short survey.
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 # ref-for-dom-document-createprocessinginstruction① |