Dokument

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 enthält Elemente wie <body> und <table>, neben vielen anderen. Er bietet globale Funktionalitäten für das Dokument, z. B. wie die URL der Seite abgerufen und neue Elemente im Dokument erstellt werden können.

Die Document-Schnittstelle beschreibt die gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Typ des Dokuments (z. B. HTML, XML, SVG, …) ist eine größere API verfügbar: HTML-Dokumente, die mit dem "text/html"-Inhaltstyp bereitgestellt 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 ein Array erstellter Stylesheets hinzu, die vom Dokument verwendet werden sollen. Diese Stylesheets können auch mit Shadow-DOM-Unterbäumen desselben Dokuments geteilt werden.
Document.body: Gibt den <body>- oder <frameset>-Knoten des aktuellen Dokuments zurück.
Document.characterSet Schreibgeschützt: Gibt das Zeichensatz zurück, das vom Dokument verwendet wird.
Document.childElementCount Schreibgeschützt: Gibt die Anzahl der Kindelemente des aktuellen Dokuments zurück.
Document.children Schreibgeschützt: Gibt die Kindelemente des aktuellen Dokuments zurück.
Document.compatMode Schreibgeschützt: Gibt an, ob das Dokument im Quirks- oder Strict-Modus gerendert wird.
Document.contentType Schreibgeschützt: Gibt den Inhaltstyp 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 Kindelement des Dokuments ist. Bei HTML-Dokumenten 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 Funktionenrichtlinien zurück.
Document.firstElementChild Schreibgeschützt: Gibt das erste Kindelement 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 ausgeblendet gilt oder nicht.
Document.images Schreibgeschützt: Gibt eine HTMLCollection der Bilder im Dokument zurück.
Document.implementation Schreibgeschützt: Gibt die dem aktuellen Dokument zugeordnete DOM-Implementierung zurück.
Document.lastElementChild Schreibgeschützt: Gibt das letzte Kindelement des aktuellen Dokuments zurück.
Document.links Schreibgeschützt: Gibt eine HTMLCollection der Hyperlinks im Dokument zurück.
Document.pictureInPictureElement Schreibgeschützt: Gibt das Element zurück, das derzeit im Bild-im-Bild-Modus in diesem Dokument präsentiert wird.
Document.pictureInPictureEnabled Schreibgeschützt: Gibt wahr zurück, wenn die Bild-im-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 wenn sich das Ziel in einem anderen Dokument befindet.
Document.prerendering Schreibgeschützt Experimentell: Gibt einen booleschen Wert zurück, der angibt, ob das Dokument derzeit im Prozess des Vorabladens ist, wie durch die Speculation Rules API initiiert.
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 Timeline 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 Sichtbarkeitszustand des Dokuments bezeichnet. 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 semikolongetrennte 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

Ruft die Fähigkeit ab, das gesamte Dokument zu bearbeiten, oder legt diese fest.

Document.dir

Ruft die Richtung (rtl/ltr) des Dokuments ab oder legt diese 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 geändert wurde.

Document.location Schreibgeschützt

Gibt die URI des aktuellen Dokuments zurück.

Document.readyState Schreibgeschützt

Gibt den Ladezustand des Dokuments zurück.

Document.referrer Schreibgeschützt

Gibt die URI der Seite zurück, die zu dieser Seite verlinkt hat.

Document.title

Setzt oder ruft den Titel des aktuellen Dokuments ab.

Document.URL Schreibgeschützt

Gibt den Dokumentstandort als Zeichenkette zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften exponiert:

Für jedes <embed>, <form>, <iframe>, <img> und <object>-Element wird dessen name (falls nicht leer) exponiert. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann gibt document["my_form"] (und sein Äquivalent document.my_form) eine Referenz auf dieses Element zurück.
Für jedes <object>-Element wird dessen id (falls nicht leer) exponiert.
Für jedes <img>-Element mit nicht leerem name wird dessen id (falls nicht leer) exponiert.

Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn dieses einzelne Element ein iframe ist, wird stattdessen dessen contentWindow zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine HTMLCollection zurückgegeben, die alle enthält.

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe aktiver Links im Dokumentenkörper zurück oder setzt sie.
Document.all Veraltet: Bietet Zugriff auf alle Elemente im Dokument — es gibt eine HTMLAllCollection zurück, die am 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: Ruft die Hintergrundfarbe des aktuellen Dokuments ab oder setzt diese.
Document.charset Veraltet Schreibgeschützt: Alias für Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain Veraltet: Ruft die Domain des aktuellen Dokuments ab oder legt sie fest.
Document.fgColor Veraltet: Ruft die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments ab oder setzt diese.
Document.fullscreen Veraltet: Gibt true zurück, wenn sich das Dokument im Vollbildmodus befindet.
Document.inputEncoding Veraltet Schreibgeschützt: Alias für Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt den Namen des zuletzt aktivierten Stylesheet-Sets zurück. Hat den Wert null, bis das Stylesheet durch Einstellen des Werts von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet: Ruft die Farbe von Hyperlinks im Dokument ab oder setzt diese.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt das bevorzugte Style-Sheet-Set zurück, wie vom Seitenautor angegeben.
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: Ruft die Farbe besuchter Hyperlinks ab oder setzt diese.
Document.xmlEncoding Veraltet: Gibt die Kodierung zurück, wie sie von der XML-Deklaration bestimmt wird.
Document.xmlStandalone Veraltet: Gibt true zurück, wenn die XML-Deklaration angibt, dass das Dokument eigenständig ist (z. B. beeinflusst ein externer Teil der DTD den Inhalt des Dokuments), andernfalls false.
Document.xmlVersion Veraltet: Gibt die Versionsnummer zurück, wie sie in der XML-Deklaration angegeben ist, oder "1.0", wenn die Deklaration fehlt.

Instanzmethoden

Diese Schnittstelle erbt auch von den Schnittstellen Node und EventTarget.

Document.adoptNode(): Übernimmt 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 wichtigsten Themen für den Benutzer darstellen, eines aus jeder der letzten drei Epochen. Standardmäßig bewirkt die Methode auch, dass der Browser den aktuellen Seitenbesuch als vom Anrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in die Themenberechnung einbezogen werden kann. See the Topics API für weitere Einzelheiten.
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, sowie das Zeichenoffset des Carets innerhalb dieses Knotens.
Document.caretRangeFromPoint() Nicht standardisiert: Erhält 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 einen neuen Attributknoten in einem bestimmten Namespace und gibt ihn 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 gegebenen Tag-Namen.
Document.createElementNS(): Erstellt ein neues Element mit dem angegebenen Tag-Namen und Namespace-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 die Anzeige des Vollbildmodus des Dokuments.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-im-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock(): Löst die Zeigerverriegelung.
Document.getAnimations(): Gibt ein Array aller Animation-Objekte zurück, die derzeit wirksam sind und 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 Namespace zurück.
Document.getSelection(): Gibt ein Selection-Objekt zurück, das den vom Benutzer ausgewählten Textbereich repräsentiert, oder die aktuelle Position des Carets.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem booleschen Wert erfüllt wird, der anzeigt, 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: Bewegt einen gegebenen Node innerhalb des Document-DOM-Knotens als direktes Kind vor einem gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht es Ihnen, das als Hintergrundbild verwendete Element für eine bestimmte Element-ID zu ändern.
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 zurück, in Dokumentreihenfolge, der die angegebenen Selektoren angibt.
Document.querySelectorAll(): Gibt eine Liste aller Elementknoten im Dokument zurück, die die angegebenen Selektoren angeben.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Maussteuerung frei, wenn sie sich auf einem Element in diesem Dokument befindet.
Document.releaseEvents() Veraltet: Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die bestehenden Kinder eines Dokuments durch eine bestimmte neue Menge an Kindern.
Document.requestStorageAccess(): Ermöglicht einem Dokument, das in einem Drittanbieter-Kontext (d.h. eingebettet in ein <iframe>) geladen ist, Zugriff auf nicht partitionierte Cookies zu beantragen, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf nicht partitionierte Cookies durch in einem Drittanbieter-Kontext geladene Sites blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Ermöglicht es Hauptseiten, den Zugriff auf Drittanbieter-Cookies im Namen von eingebetteten Inhalten zu beantragen, die von anderen Sites in demselben zusammengehörigen Websitesets stammen.
Document.startViewTransition(): Startet einen neuen Ansichtstransition und gibt ein ViewTransition-Objekt zurück, das sie darstellt.

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

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

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 zum Schreiben.
Document.execCommand() Veraltet: Führt in einem editierbaren Dokument einen Formatierungsbefehl aus.
Document.getElementsByName(): Gibt eine Liste von Elementen mit dem angegebenen Namen zurück.
Document.hasFocus(): Gibt true zurück, wenn der Fokus derzeit irgendwo im angegebenen Dokument liegt.
Document.open(): Öffnet einen Dokumentstrom zum 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() Veraltet: Schreibt eine Textzeile in ein Dokument.

Statische Methoden

Diese Schnittstelle erbt auch von den Schnittstellen Node und EventTarget.

Document.parseHTML(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenfolge auf XSS-sichere Weise mit Sanitisierung.
Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenfolge ohne Durchführung der Sanitisierung. Die Zeichenfolge darf deklarative Schattenwurzeln enthalten.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisen eines Ereignis-Listeners an die oneventname-Eigenschaft dieser Schnittstelle ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus Knoten im Dokumentbaum hervorkommen.

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script>-Element das Ausführen seines Skripts beendet hat.
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, bevor ein statisches <script> mit der Ausführung beginnt.
prerenderingchange Experimentell: Wird auf einem vorgeladenen Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer sieht die Seite).
securitypolicyviolation: Wird ausgelöst, wenn eine Inhaltsrichtliniensicherheit verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wurde oder ausgeblendet wurde.

Vollbildereignisse

fullscreenchange: Wird ausgelöst, wenn das Document in den Vollbildmodus oder aus diesem heraus wechselt.
fullscreenerror: Wird ausgelöst, wenn beim Versuch, in den Vollbildmodus zu wechseln oder aus diesem herauszukommen, ein Fehler auftritt.

Lade- und Entladeereignisse

DOMContentLoaded: Wird ausgelöst, wenn das Dokument vollständig geladen und geparst wurde, ohne dass auf das Laden von Stylesheets, Bildern und Unterframes gewartet wird.
readystatechange: Wird ausgelöst, wenn sich das readyState-Attribut eines Dokuments geändert hat.

Zeigersperre Ereignisse

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

Scrollereignisse

scroll: Wird ausgelöst, wenn die Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Scrollen der Dokumentansicht oder eines Elements abgeschlossen ist.
scrollsnapchange Experimentell: Wird am Scrollcontainer am Ende einer Scrolloperation ausgelöst, wenn ein neues Scrollsnap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell: Wird am Scrollcontainer ausgelöst, wenn der Browser bestimmt, dass ein neues Scrollsnap-Ziel anhängig ist, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahlereignisse

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

Bubbelnde Ereignisse

Nicht alle bubbelnden Ereignisse können das Document-Objekt erreichen. Nur die folgenden tun dies und können für das Document-Objekt gehö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