Document

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.

* Some parts of this feature may have varying levels of support.

Die Document-Schnittstelle repräsentiert jede im Browser geladene Webseite und dient als Einstiegspunkt in den Inhalt der Webseite, der der DOM-Baum ist.

Der DOM-Baum umfasst Elemente wie <body> und <table>, unter vielen anderen. Er bietet global Funktionalität für das Dokument, wie die Möglichkeit, die URL der Seite zu erhalten und neue Elemente im Dokument zu erstellen.

Die Document-Schnittstelle beschreibt die allgemeinen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Dokumenttyp (z. B. HTML, XML, SVG, …) steht eine größere API zur Verfügung: HTML-Dokumente, die mit dem Inhaltstyp "text/html" bedient werden, implementieren auch die HTMLDocument-Schnittstelle, während XML- und SVG-Dokumente die XMLDocument-Schnittstelle implementieren.

Konstruktor

Document(): Erstellt ein neues Document-Objekt.

Instanz-Eigenschaften

Diese Schnittstelle erbt auch von den Schnittstellen Node und EventTarget.

Document.activeElement Schreibgeschützt: Gibt das Element zurück, das derzeit den Fokus hat.
Document.adoptedStyleSheets: Fügt dem Dokument ein Array von konstruierten Stylesheets hinzu. Diese Stylesheets können auch mit Shadow-DOM-Subbäumen desselben Dokuments geteilt werden.
Document.body: Gibt den <body> oder <frameset> Knoten des aktuellen Dokuments zurück.
Document.characterSet Schreibgeschützt: Gibt den Zeichensatz zurück, der vom Dokument verwendet wird.
Document.childElementCount Schreibgeschützt: Gibt die Anzahl der Kind-Elemente des aktuellen Dokuments zurück.
Document.children Schreibgeschützt: Gibt die Kind-Elemente des aktuellen Dokuments zurück.
Document.compatMode Schreibgeschützt: Zeigt an, ob das Dokument im quirks- oder strict-Modus gerendert wird.
Document.contentType Schreibgeschützt: Gibt den Content-Type aus dem MIME-Header des aktuellen Dokuments zurück.
Document.currentScript Schreibgeschützt: Gibt das <script> element zurück, dessen Skript derzeit verarbeitet wird und kein JavaScript-Modul ist.
Document.doctype Schreibgeschützt: Gibt die Document Type Definition (DTD) des aktuellen Dokuments zurück.
Document.documentElement Schreibgeschützt: Gibt das Element zurück, das ein direktes Kind des Dokuments ist. Für HTML-Dokumente ist dies normalerweise das HTMLHtmlElement-Objekt, das das <html> Element des Dokuments darstellt.
Document.documentURI Schreibgeschützt: Gibt den Dokumentstandort als Zeichenkette zurück.
Document.embeds Schreibgeschützt: Gibt eine HTMLCollection der eingebetteten <embed> Elemente im Dokument zurück.
Document.featurePolicy Experimentell Schreibgeschützt: Gibt die FeaturePolicy-Schnittstelle mit den auf das Dokument angewendeten Feature-Policies zurück.
Document.firstElementChild Schreibgeschützt: Gibt das erste Kind-Element des aktuellen Dokuments zurück.
Document.fonts: Gibt die FontFaceSet-Schnittstelle des aktuellen Dokuments zurück.
Document.forms Schreibgeschützt: Gibt eine HTMLCollection der <form> Elemente im Dokument zurück.
Document.fragmentDirective Schreibgeschützt: Gibt die FragmentDirective für das aktuelle Dokument zurück.
Document.fullscreenElement Schreibgeschützt: Das Element, das sich derzeit im Vollbildmodus für dieses Dokument befindet.
Document.head Schreibgeschützt: Gibt das <head> Element des aktuellen Dokuments zurück.
Document.hidden Schreibgeschützt: Gibt einen Booleschen Wert zurück, der anzeigt, ob die Seite als verborgen betrachtet wird oder nicht.
Document.images Schreibgeschützt: Gibt eine HTMLCollection der Bilder im Dokument zurück.
Document.implementation Schreibgeschützt: Gibt die DOM-Implementierung zurück, die mit dem aktuellen Dokument verknüpft ist.
Document.lastElementChild Schreibgeschützt: Gibt das letzte Kind-Element des aktuellen Dokuments zurück.
Document.links Schreibgeschützt: Gibt eine HTMLCollection der Hyperlinks im Dokument zurück.
Document.pictureInPictureElement Schreibgeschützt: Gibt das derzeit präsentierte Element im Bild-in-Bild-Modus in diesem Dokument zurück.
Document.pictureInPictureEnabled Schreibgeschützt: Gibt true zurück, wenn die Bild-in-Bild-Funktion aktiviert ist.
Document.plugins Schreibgeschützt: Gibt eine HTMLCollection der verfügbaren Plugins zurück.
Document.pointerLockElement Schreibgeschützt: Gibt das Element zurück, das als Ziel für Mausereignisse festgelegt ist, während der Zeiger gesperrt ist. null, wenn die Sperre aussteht, der Zeiger entsperrt ist oder das Ziel sich in einem anderen Dokument befindet.
Document.prerendering Schreibgeschützt Experimentell: Gibt einen Booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prozesse des Vorabladens ist, wie es über die Speculation Rules API initiiert wurde.
Document.scripts Schreibgeschützt: Gibt eine HTMLCollection der <script> Elemente im Dokument zurück.
Document.scrollingElement Schreibgeschützt: Gibt eine Referenz auf das Element zurück, das das Dokument scrollt.
Document.styleSheets Schreibgeschützt: Gibt eine StyleSheetList von CSSStyleSheet-Objekten für Stylesheets zurück, die explizit in ein Dokument verlinkt oder eingebettet sind.
Document.timeline Schreibgeschützt: Gibt die Zeitleiste als spezielle Instanz von DocumentTimeline zurück, die beim Laden der Seite automatisch erstellt wird.
Document.visibilityState Schreibgeschützt: Gibt einen string zurück, der den Sichtbarkeitsstatus des Dokuments angibt. Mögliche Werte sind visible, hidden, prerender und unloaded.

Erweiterungen für HTMLDocument

Die Document-Schnittstelle für HTML-Dokumente erbt von der HTMLDocument-Schnittstelle oder wird für solche Dokumente erweitert.

Document.cookie: Gibt eine durch Semikolon getrennte Liste der Cookies für dieses Dokument zurück oder setzt ein einzelnes Cookie.
Document.defaultView Schreibgeschützt: Gibt eine Referenz auf das Fensterobjekt zurück.
Document.designMode: Erhält/legt fest, ob das gesamte Dokument bearbeitet werden kann.
Document.dir: Erhält/legt die Richtung (rtl/ltr) des Dokuments fest.
Document.fullscreenEnabled Schreibgeschützt: Gibt an, ob der Vollbildmodus verfügbar ist.
Document.lastModified Schreibgeschützt: Gibt das Datum zurück, an dem das Dokument zuletzt bearbeitet wurde.
Document.location Schreibgeschützt: Gibt den URI des aktuellen Dokuments zurück.
Document.readyState Schreibgeschützt: Gibt den Ladezustand des Dokuments zurück.
Document.referrer Schreibgeschützt: Gibt den URI der Seite zurück, die zu dieser Seite verlinkt hat.
Document.title: Legt den Titel des aktuellen Dokuments fest oder ruft ihn ab.
Document.URL Schreibgeschützt: Gibt den Dokumentstandort als Zeichenkette zurück.

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe aktiver Links im Dokumentkörper zurück oder legt sie fest.
Document.all Veraltet: Bietet Zugriff auf alle Elemente im Dokument — es gibt eine HTMLAllCollection zurück, die an der Dokumentknoten verwurzelt ist. Dies ist eine alte, nicht-standardisierte Eigenschaft und sollte nicht verwendet werden.
Document.anchors Veraltet Schreibgeschützt: Gibt eine Liste aller Anker im Dokument zurück.
Document.applets Veraltet Schreibgeschützt: Gibt eine leere HTMLCollection zurück. Eine alte Eigenschaft, die früher die Liste der Applets innerhalb eines Dokuments zurückgab.
Document.bgColor Veraltet: Erhält/legt die Hintergrundfarbe des aktuellen Dokuments fest.
Document.charset Veraltet Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain Veraltet: Erhält/legt die Domain des aktuellen Dokuments fest.
Document.fgColor Veraltet: Erhält/legt die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments fest.
Document.fullscreen Veraltet: Gibt true zurück, wenn sich das Dokument im Vollbildmodus befindet.
Document.inputEncoding Veraltet Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt den Namen des zuletzt aktivierten Stylesheets zurück. Der Wert ist null, bis das Stylesheet durch Einstellen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet: Erhält/legt die Farbe der Hyperlinks im Dokument fest.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt das bevorzugte Stylesheet-Set zurück, wie vom Seitenautor festgelegt.
Document.rootElement Veraltet: Wie Document.documentElement, aber nur für <svg> Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet Veraltet Nicht standardisiert: Gibt zurück, welches Stylesheet-Set derzeit verwendet wird.
Document.styleSheetSets Veraltet Schreibgeschützt Nicht standardisiert: Gibt eine Liste der im Dokument verfügbaren Stylesheet-Sets zurück.
Document.vlinkColor Veraltet: Erhält/legt die Farbe der besuchten Hyperlinks fest.
Document.xmlEncoding Veraltet: Gibt die Codierung zurück, wie sie in der XML-Deklaration bestimmt wurde.
Document.xmlStandalone Veraltet: Gibt true zurück, wenn die XML-Deklaration angibt, dass das Dokument alleine steht (z.B., Ein externer Teil der DTD beeinflusst den Inhalt des Dokuments), sonst false.
Document.xmlVersion Veraltet: Gibt die Versionsnummer zurück, wie in der XML-Deklaration angegeben, oder "1.0", wenn die Erklärung fehlt.

Instanz-Methoden

Diese Schnittstelle erbt auch von den Schnittstellen Node und EventTarget.

Document.adoptNode(): Adoptiert einen Knoten aus einem externen Dokument.
Document.append(): Fügt eine Menge von Node-Objekten oder Zeichenfolgen nach dem letzten Kind des Dokuments ein.
Document.browsingTopics() Experimentell Nicht standardisiert: Gibt ein Versprechen zurück, das mit einem Array von Objekten erfüllt wird, die die Top-Themen für den Benutzer darstellen, eines aus jedem der letzten drei Epochen. Standardmäßig bewirkt die Methode auch, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung verwendet werden kann. Siehe die Topics API für mehr Details.
Document.captureEvents() Veraltet: Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition-Objekt zurück, das den DOM-Knoten enthält, der den Caret enthält, und die Zeichenoffset des Carets innerhalb dieses Knotens.
Document.caretRangeFromPoint() Nicht standardisiert: Holt ein Range-Objekt für das Dokumentfragment unter den angegebenen Koordinaten.
Document.createAttribute(): Erstellt ein neues Attr-Objekt und gibt es zurück.
Document.createAttributeNS(): Erstellt ein neues Attributknoten in einem bestimmten Namensraum und gibt es zurück.
Document.createCDATASection(): Erstellt einen neuen CDATA-Knoten und gibt ihn zurück.
Document.createComment(): Erstellt einen neuen Kommentarknoten und gibt ihn zurück.
Document.createDocumentFragment(): Erstellt ein neues Dokumentfragment.
Document.createElement(): Erstellt ein neues Element mit dem angegebenen Tag-Namen.
Document.createElementNS(): Erstellt ein neues Element mit dem angegebenen Tag-Namen und Namensraum-URI.
Document.createEvent() Veraltet: Erstellt ein Ereignisobjekt.
Document.createNodeIterator(): Erstellt ein NodeIterator-Objekt.
Document.createProcessingInstruction(): Erstellt ein neues ProcessingInstruction-Objekt.
Document.createRange(): Erstellt ein Range-Objekt.
Document.createTextNode(): Erstellt einen Textknoten.
Document.createTouch() Veraltet Nicht standardisiert: Erstellt ein Touch-Objekt.
Document.createTouchList() Veraltet Nicht standardisiert: Erstellt ein TouchList-Objekt.
Document.createTreeWalker(): Erstellt ein TreeWalker-Objekt.
Document.elementFromPoint(): Gibt das oberste Element an den angegebenen Koordinaten zurück.
Document.elementsFromPoint(): Gibt ein Array aller Elemente an den angegebenen Koordinaten zurück.
Document.enableStyleSheetsForSet() Veraltet Nicht standardisiert: Aktiviert die Stylesheets für das angegebene Stylesheet-Set.
Document.exitFullscreen(): Beendet das Vollbild-Element des Dokuments aus dem Vollbildmodus.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück zu seinem ursprünglichen Container.
Document.exitPointerLock(): Gibt die Zeigersperre frei.
Document.getAnimations(): Gibt ein Array aller Animation-Objekte zurück, die aktuell wirksam sind, deren Zielelemente Nachkommen des Dokuments sind.
Document.getBoxQuads() Experimentell: Gibt eine Liste von DOMQuad-Objekten zurück, die die CSS-Fragmente des Knotens darstellen.
Document.getElementById(): Gibt eine Objektreferenz auf das identifizierte Element zurück.
Document.getElementsByClassName(): Gibt eine Liste von Elementen mit dem angegebenen Klassennamen zurück.
Document.getElementsByTagName(): Gibt eine Liste von Elementen mit dem angegebenen Tag-Namen zurück.
Document.getElementsByTagNameNS(): Gibt eine Liste von Elementen mit dem angegebenen Tag-Namen und Namensraum zurück.
Document.getSelection(): Gibt ein Selection-Objekt zurück, das den Bereich des vom Benutzer ausgewählten Texts oder die aktuelle Position des Carets darstellt.
Document.hasStorageAccess(): Gibt eine Promise zurück, die mit einem booleschen Wert erfüllt wird, der angibt, ob das Dokument Zugriff auf nicht partitionierte Cookies hat.
Document.hasUnpartitionedCookieAccess(): Neuer Name für Document.hasStorageAccess().
Document.importNode(): Gibt einen Klon eines Knotens aus einem externen Dokument zurück.
Document.moveBefore() Experimentell: Verschiebt einen gegebenen Node innerhalb des Document DOM-Knotens als direktes Kind, vor einem gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann wieder einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Erlaubt es Ihnen, das Element zu ändern, das als Hintergrundbild für eine angegebene Element-ID verwendet wird.
Document.prepend(): Fügt eine Menge von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt den ersten Elementknoten im Dokument in Dokumentenreihenfolge zurück, der den angegebenen Selektoren entspricht.
Document.querySelectorAll(): Gibt eine Liste aller Elementknoten im Dokument zurück, die den angegebenen Selektoren entsprechen.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Maus-Erfassung frei, wenn sie auf ein Element in diesem Dokument gerichtet ist.
Document.releaseEvents() Veraltet: Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die vorhandenen Kinder eines Dokuments durch einen festgelegten neuen Satz von Kindern.
Document.requestStorageAccess(): Ermöglicht es einem Dokument, das in einem Drittanbieter-Kontext geladen ist (d.h. eingebettet in ein <iframe>), Zugriff auf nicht partitionierte Cookies anzufordern, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf nicht partitionierte Cookies von Sites blockieren, die in einem Drittanbieter-Kontext geladen werden, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Erlaubt es Top-Level-Sites, den Drittanbieter-Cookie-Zugriff im Namen von eingebetteten Inhalten zu beantragen, die von einer anderen Site im selben Related Website Set stammen.
Document.startViewTransition(): Startet einen neuen View Transition und gibt ein ViewTransition-Objekt zurück, um sie darzustellen.

Die Document-Schnittstelle wird mit der XPathEvaluator-Schnittstelle erweitert:

Document.createExpression(): Kompiliert ein XPathExpression, das dann für (wiederholte) Auswertungen verwendet werden kann.
Document.createNSResolver() Veraltet: Gibt den Eingabeknoten unverändert zurück.
Document.evaluate(): Wertet einen XPath-Ausdruck aus.

Erweiterung für HTML-Dokumente

Die Document-Schnittstelle für HTML-Dokumente erbt von der HTMLDocument-Schnittstelle oder wird für solche Dokumente erweitert:

Document.clear() Veraltet: Diese Methode tut nichts.
Document.close(): Schließt einen Dokumentstrom für das Schreiben.
Document.execCommand() Veraltet: Führt einen Formatierungsbefehl in einem bearbeitbaren Dokument aus.
Document.getElementsByName(): Gibt eine Liste von Elementen mit dem angegebenen Namen zurück.
Document.hasFocus(): Gibt true zurück, wenn der Fokus sich derzeit irgendwo innerhalb des angegebenen Dokuments befindet.
Document.open(): Öffnet einen Dokumentstrom für das Schreiben.
Document.queryCommandEnabled() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich ausgeführt werden kann.
Document.queryCommandIndeterm() Veraltet: Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich in einem unbestimmten Zustand ist.
Document.queryCommandState() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich ausgeführt wurde.
Document.queryCommandSupported() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich unterstützt wird.
Document.queryCommandValue() Veraltet: Gibt den aktuellen Wert des aktuellen Bereichs für einen Formatierungsbefehl zurück.
Document.write() Veraltet: Schreibt Text in ein Dokument.
Document.writeln(): Schreibt eine Textzeile in ein Dokument.

Statische Methoden

Diese Schnittstelle erbt auch von den Schnittstellen Node und EventTarget.

Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenkette, ohne eine Bereinigung durchzuführen. Die Zeichenkette kann deklarative Schattenwurzeln enthalten.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuordnen eines Ereignislisteners zur oneventname-Eigenschaft dieser Schnittstelle ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten stammen, die sich im Dokumentbaum befinden.

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> Element sein Skript beendet hat.
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> Element kurz vor dem Start der Ausführung steht.
prerenderingchange Experimentell: Wird bei einem vorab geladenen Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite betrachtet).
securitypolicyviolation: Wird ausgelöst, wenn eine Inhalts-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wird oder verborgen wird.

Vollbild-Ereignisse

fullscreenchange: Wird ausgelöst, wenn das Document in den Vollbildmodus wechselt oder diesen verlässt.
fullscreenerror: Wird ausgelöst, wenn beim Wechsel in den oder aus dem Vollbildmodus ein Fehler auftritt.

Lade- & Entlade-Ereignisse

DOMContentLoaded: Wird ausgelöst, wenn das Dokument vollständig geladen und geparst wurde, ohne darauf zu warten, dass Stylesheets, Bilder und Subframes fertig geladen werden.
readystatechange: Wird ausgelöst, wenn sich das readyState Attribut eines Dokuments ändert.

Zeigersperre-Ereignisse

pointerlockchange: Wird ausgelöst, wenn der Zeiger gesperrt/entsperrt wird.
pointerlockerror: Wird ausgelöst, wenn das Sperren des Zeigers fehlgeschlagen ist.

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn die Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn die Dokumentansicht oder ein Element mit dem Scrollen fertig ist.
scrollsnapchange Experimentell: Wird auf dem Scroll-Container am Ende einer Scroll-Operation ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell: Wird auf dem Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.

Auswahl-Ereignisse

selectionchange: Wird ausgelöst, wenn die aktuelle Textauswahl in einem Dokument geändert wird.

Gebubbelte Ereignisse

Nicht alle Ereignisse, die bubbeln, können das Document-Objekt erreichen. Nur die folgenden tun dies und können am Document-Objekt abgehört werden:

Spezifikationen

Specification
DOM # interface-document
HTML # the-document-object
CSSOM View Module # extensions-to-the-document-interface
Pointer Lock 2.0 # extensions-to-the-document-interface
Selection API # extensions-to-document-interface