DOMImplementation: createDocument() 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.

Die createDocument() Methode der DOMImplementation Schnittstelle erstellt und gibt ein XMLDocument zurück.

In diesem Artikel

Syntax

js
createDocument(namespaceURI, qualifiedName)
createDocument(namespaceURI, qualifiedName, documentType)

Parameter

namespaceURI

Ein String, der die Namespace-URI des zu erstellenden Dokuments angibt, oder null, wenn das Dokument keinem Namespace angehört.

qualifiedName

Ein String, der den qualifizierten Namen des zu erstellenden Dokuments angibt. Ein null Wert wird wie ein leerer String ("") behandelt.

Das Format des qualifizierten Namens lautet prefix:localName oder localName, wobei die Teile wie folgt definiert sind:

prefix Optional

Ein „kurzes Alias“ für den Namespace. Der Präfix ist optional, aber wenn er angegeben ist, muss auch der namespaceURI-Parameter angegeben werden. Wenn der Präfix auf xml oder xmlns gesetzt ist, muss der namespaceURI auf http://www.w3.org/XML/1998/namespace oder http://www.w3.org/2000/xmlns/ gesetzt werden. Standardmäßig null.

localName

Der lokale Name des Dokuments.

documentType Optional

Der DocumentType des zu erstellenden Dokuments. Standardmäßig null.

Rückgabewert

Das neu erstellte XMLDocument.

Ausnahmen

NamespaceError DOMException

Wird ausgelöst, wenn der Wert von namespaceURI:

keine gültige Namespace-URI ist.
auf einen leeren String gesetzt ist, wenn prefix einen Wert hat.
nicht der Wert http://www.w3.org/XML/1998/namespace oder http://www.w3.org/2000/xmlns/ ist, wenn prefix auf xml oder xmlns gesetzt ist.

InvalidCharacterError DOMException

Wird ausgelöst, wenn entweder der prefix oder localName nicht gültig ist:

Der prefix muss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen, NULL, / oder > (U+0000, U+002F oder U+003E, jeweils) enthalten.
Der localName ist ein gültiger Elementname, wenn er eine Länge von mindestens 1 hat und:
- er mit einem Buchstaben beginnt und keine ASCII-Leerzeichen, NULL, / oder > (U+0000, U+002F oder U+003E, jeweils) enthält.
- er mit : (U+003A), _ (U+005F) oder irgendeinem Zeichen im Bereich von U+0080 bis U+10FFFF (inklusive) beginnt und die restlichen Codepunkte nur diese gleichen Zeichen sowie die ASCII-alphanumerischen Zeichen, - (U+002D) und . (U+002E) umfassen.

Hinweis: Frühere Versionen der Spezifikation waren restriktiver und erforderten, dass der qualifiedName ein gültiger XML-Name ist.

Beispiele

Grundlegende Verwendung

js
const doc = document.implementation.createDocument(
  "http://www.w3.org/1999/xhtml",
  "html",
  null,
);
const body = document.createElementNS("http://www.w3.org/1999/xhtml", "body");
body.setAttribute("id", "abc");
doc.documentElement.appendChild(body);
alert(doc.getElementById("abc")); // [object HTMLBodyElement]

Die DOMImplementation Schnittstelle, zu der es gehört.

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)
DOMImplementation
Instanzmethoden
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