Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Dokument

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

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

Das Document Interface stellt jede im Browser geladene Webseite dar und dient als Einstiegspunkt in die Inhalte der Webseite, die den DOM-Baum bilden.

Der DOM-Baum enthält Elemente wie <body> und <table>, sowie viele andere. Er bietet globale Funktionalitäten für das Dokument, wie z. B. das Abrufen der URL der Seite und das Erstellen neuer Elemente im Dokument.

EventTarget Node Document

Das Document Interface beschreibt die allgemeinen Eigenschaften und Methoden für jede Art von Dokument. Je nach Typ des Dokuments (z. B. HTML, XML, SVG, …) steht eine umfangreichere API zur Verfügung: HTML-Dokumente, die mit dem Inhaltstyp "text/html" bereitgestellt werden, implementieren auch das HTMLDocument Interface, während XML- und SVG-Dokumente das XMLDocument Interface implementieren.

Konstruktor

Document()

Erstellt ein neues Document Objekt.

Instanz-Eigenschaften

Dieses Interface erbt auch von den Interfaces 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 aus konstruierten Stylesheets hinzu. Diese Stylesheets können auch mit Shadow DOM Teilbä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 Kindelemente des aktuellen Dokuments zurück.

Document.children Schreibgeschützt

Gibt die Kindelemente 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 momentan verarbeitet wird und kein JavaScript-Modul ist.

Document.doctype Schreibgeschützt

Gibt die Dokumententyp-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 repräsentiert.

Document.documentURI Schreibgeschützt

Gibt den Dokumentenstandort als Zeichenfolge zurück.

Document.embeds Schreibgeschützt

Gibt eine HTMLCollection der eingebetteten <embed> Elemente im Dokument zurück.

Document.featurePolicy Experimentell Schreibgeschützt

Gibt das FeaturePolicy Interface mit den auf das Dokument angewendeten Feature-Policies zurück.

Document.firstElementChild Schreibgeschützt

Gibt das erste Kindelement des aktuellen Dokuments zurück.

Document.fonts

Gibt das FontFaceSet Interface 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 aktuell 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 angibt, 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 mit dem aktuellen Dokument verbundene DOM-Implementierung zurück.

Document.lastElementChild Schreibgeschützt

Gibt das letzte Kindelement des aktuellen Dokuments zurück.

Gibt eine HTMLCollection der Hyperlinks im Dokument zurück.

Document.pictureInPictureElement Schreibgeschützt

Gibt das Element zurück, das derzeit im Picture-in-Picture-Modus in diesem Dokument präsentiert wird.

Document.pictureInPictureEnabled Schreibgeschützt

Gibt true zurück, wenn das Picture-in-Picture-Feature 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 gesetzt ist, während der Zeiger gesperrt ist. null, wenn die Sperre aussteht, der Zeiger entsperrt ist oder wenn das Ziel in einem anderen Dokument ist.

Document.prerendering Schreibgeschützt Experimentell

Gibt einen booleschen Wert zurück, der angibt, ob das Dokument derzeit im Prozess des Prerenderings ist, wie über 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 der CSSStyleSheet Objekte für Stylesheets zurück, die explizit in das Dokument eingebunden oder eingebettet sind.

Document.timeline Schreibgeschützt

Gibt die Zeitachse 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 anzeigt. Mögliche Werte sind visible, hidden und unloaded.

Erweiterungen für HTMLDocument

Das Document Interface für HTML-Dokumente erbt vom HTMLDocument Interface 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 Window-Objekt zurück.

Document.designMode

Ermöglicht das Abrufen/Setzen der Fähigkeit, das gesamte Dokument zu bearbeiten.

Document.dir

Ermöglicht das Abrufen/Setzen der Richtung (rtl/ltr) des Dokuments.

Document.fullscreenEnabled Schreibgeschützt

Zeigt 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 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 auf diese Seite verlinkt hat.

Document.title

Setzt oder erhält den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt den Dokumentenstandort als Zeichenfolge zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften exponiert:

  • Für jedes <embed>, <form>, <iframe>, <img>, und <object> Element wird sein name (falls nicht leer) exponiert. Wenn das Dokument zum Beispiel <form name="my_form"> enthält, dann gibt document["my_form"] (und dessen Äquivalent document.my_form) eine Referenz auf dieses Element zurück.
  • Für jedes <object> Element wird seine id (falls nicht leer) exponiert.
  • Für jedes <img> Element mit nicht leerem name, wird seine 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 sein 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 der aktiven Links im Dokument zurück oder setzt sie.

Document.all Veraltet

Bietet Zugriff auf alle Elemente im Dokument — es gibt eine HTMLAllCollection zurück, die im Dokumentknoten verwurzelt ist. Dies ist eine veraltete, 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. Veraltete Eigenschaft, die früher die Liste der Applets in einem Dokument zurückgab.

Document.bgColor Veraltet

Ermöglicht das Abrufen/Setzen der Hintergrundfarbe des aktuellen Dokuments.

Document.charset Veraltet Schreibgeschützt

Alias für Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.

Document.domain Veraltet

Ermöglicht das Abrufen/Setzen der Domain des aktuellen Dokuments.

Document.fgColor Veraltet

Ermöglicht das Abrufen/Setzen der Vordergrundfarbe oder Textfarbe des aktuellen Dokuments.

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 das Setzen des Wertes von selectedStyleSheetSet geändert wird.

Document.linkColor Veraltet

Ermöglicht das Abrufen/Setzen der Farbe der Hyperlinks im Dokument.

Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert

Gibt das bevorzugte Stylesheet-Set zurück, wie es vom Seitenautor angegeben wurde.

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 auf dem Dokument verfügbaren Stylesheet-Sets zurück.

Document.vlinkColor Veraltet

Ermöglicht das Abrufen/Setzen der Farbe besuchter Hyperlinks.

Document.xmlEncoding Veraltet

Gibt die Kodierung zurück, die durch die XML-Deklaration bestimmt wird.

Document.xmlStandalone Veraltet

Gibt true zurück, wenn die XML-Deklaration angibt, dass das Dokument eigenständig ist (z. B., ein externer Teil der DTD beeinflusst den Inhalt des Dokuments), andernfalls false.

Document.xmlVersion Veraltet

Gibt die Versionsnummer zurück, wie in der XML-Deklaration angegeben, oder "1.0" falls die Deklaration fehlt.

Instanz-Methoden

Dieses Interface erbt auch von den Interfaces 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.ariaNotify() Experimentell Nicht standardisiert

Gibt an, dass ein bestimmter Textstring von einem Screenreader angekündigt werden soll.

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 aufzeichnet, wie vom Aufrufer beobachtet, sodass der Hostname der Seite später in die Themenberechnung einfließen kann. Siehe die Topics API für weitere Details.

Document.captureEvents() Veraltet

Siehe Window.captureEvents.

Document.caretPositionFromPoint()

Gibt ein CaretPosition Objekt zurück, das den DOM-Knoten mit dem Caret und den Zeichenversatz des Carets innerhalb dieses Knotens enthält.

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 angegebenen 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 angegebenen 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 Vollbildelements des Dokuments im Vollbildmodus.

Document.exitPictureInPicture()

Entfernt das Video aus dem schwebenden Bild-im-Bild-Fenster zurück in seinen ursprünglichen Container.

Document.exitPointerLock()

Gibt die Zeigersperre frei.

Document.getAnimations()

Gibt ein Array aller Animation Objekte zurück, die derzeit in Kraft sind und deren Zielelemente Nachfahren des document sind.

Document.getBoxQuads() Experimentell

Gibt eine Liste von DOMQuad Objekten zurück, die die CSS-Fragmente des Knotens darstellen.

Document.getElementById()

Gibt eine Objekt-Referenz 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 oder die aktuelle Position des Cursors darstellt.

Document.hasStorageAccess()

Gibt eine Promise zurück, die sich mit einem booleschen Wert erfüllt, der angibt, ob das Dokument Zugriff auf unpartitionierte Cookies hat.

Document.hasUnpartitionedCookieAccess()

Neuer Name für Document.hasStorageAccess().

Document.importNode()

Gibt eine Kopie eines Knotens aus einem externen Dokument zurück.

Document.moveBefore()

Verschiebt einen gegebenen Node innerhalb des Document DOM-Knotens als direktes Kind vor einen gegebenen Referenzknoten, ohne den Knoten zu entfernen und neu einzufügen.

Document.mozSetImageElement() Nicht standardisiert

Ermöglicht die Änderung des Elements, 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 Dokumentreihenfolge zurück, der die angegebenen Selektoren erfüllt.

Document.querySelectorAll()

Gibt eine Liste aller Elementknoten im Dokument zurück, die die angegebenen Selektoren erfüllen.

Document.releaseCapture() Nicht standardisiert

Gibt die aktuelle Mausaufnahme frei, falls sie sich auf einem Element in diesem Dokument befindet.

Document.releaseEvents() Veraltet

Siehe Window.releaseEvents().

Document.replaceChildren()

Ersetzt die vorhandenen Kinder eines Dokuments durch eine angegebene neue Menge von Kindern.

Document.requestStorageAccess()

Ermöglicht einem in einem Drittanbieterkontext geladenen Dokument (d.h. eingebettet in ein <iframe>), Zugriff auf unpartitionierte Cookies zu beantragen, in Fällen, in denen Benutzeragenten den Zugriff auf unpartitionierte Cookies von Websites, die in einem Drittanbieterkontext geladen werden, standardmäßig blockieren, um die Privatsphäre zu verbessern.

Document.requestStorageAccessFor() Experimentell

Ermöglicht es Top-Level-Websites, auf Drittanbieter-Cookie-Zugriff im Namen von eingebetteten Inhalten zuzugreifen, die von einer anderen Site im selben related website set stammen.

Document.startViewTransition()

Startet einen neuen Übergang für die Ansicht und gibt ein ViewTransition Objekt zurück, das diesen repräsentiert.

Das Document Interface wird mit dem XPathEvaluator Interface erweitert:

Document.createExpression()

Kompiliert einen XPathExpression, der dann für (wiederholte) Auswertungen verwendet werden kann.

Document.createNSResolver() Veraltet

Gibt den Eingabeknoten unverändert zurück.

Document.evaluate()

Bewertet einen XPath-Ausdruck.

Erweiterung für HTML-Dokumente

Das Document Interface für HTML-Dokumente erbt vom HTMLDocument Interface oder wird für solche Dokumente erweitert:

Document.clear() Veraltet

Diese Methode tut nichts.

Document.close()

Schließt einen Dokumentstream für das Schreiben.

Document.execCommand() Veraltet

Führt auf einem bearbeitbaren 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 Dokumentstream 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() Veraltet

Schreibt eine Textzeile in ein Dokument.

Statische Methoden

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.parseHTML()

Erstellt ein neues Document Objekt aus einem HTML-String auf XSS-sichere Weise mit Bereinigung.

Document.parseHTMLUnsafe()

Erstellt ein neues Document Objekt aus einem HTML-String ohne Bereinigung. Der String kann deklarative Schattenwurzeln enthalten.

Ereignisse

Hören Sie auf diese Ereignisse, indem Sie addEventListener() verwenden oder einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten in dem Dokumentbaum blubbern.

afterscriptexecute Nicht standardisiert Veraltet

Wird ausgelöst, wenn ein statisches <script> Element die Ausführung seines Skripts beendet hat.

beforescriptexecute Nicht standardisiert Veraltet

Wird ausgelöst, bevor ein statisches <script> mit der Ausführung beginnt.

prerenderingchange Experimentell

Wird ausgelöst, wenn ein vorgeladenes Dokument aktiviert wird (d.h. der Benutzer die Seite betrachtet).

securitypolicyviolation

Wird ausgelöst, wenn eine Content-Security-Policy verletzt wird.

visibilitychange

Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wird oder verborgen wurde.

Vollbild-Ereignisse

fullscreenchange

Wird ausgelöst, wenn das Document in den Vollbildmodus wechselt oder diesen verlässt.

fullscreenerror

Wird ausgelöst, wenn ein Fehler beim Versuch auftritt, in den Vollbildmodus zu wechseln oder diesen zu verlassen.

Lade- und Entlade-Ereignisse

DOMContentLoaded

Wird ausgelöst, wenn das Dokument vollständig geladen und geparst wurde, ohne auf das Laden von Stylesheets, Bildern und Subframes zu warten.

readystatechange

Wird ausgelöst, wenn sich das readyState Attribut eines Dokuments geändert hat.

Pointerlock-Ereignisse

pointerlockchange

Wird ausgelöst, wenn der Zeiger gesperrt/entsperrt wird.

pointerlockerror

Wird ausgelöst, wenn das Sperren des Zeigers fehlschlägt.

Scroll-Ereignisse

scroll

Wird ausgelöst, wenn das Dokument-Ansichtsfenster oder ein Element gescrollt wurde.

scrollend

Wird ausgelöst, wenn das Dokument-Ansichtsfenster oder ein Element das Scrollen abgeschlossen hat.

scrollsnapchange Experimentell

Wird am Scroll-Container am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.

scrollsnapchanging Experimentell

Wird am Scroll-Container ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel bevorsteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahl-Ereignisse

selectionchange

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

Weitergeleitete Ereignisse

Nicht alle Ereignisse, die weitergeleitet werden, können das Document Objekt erreichen. Nur die folgenden werden weitergeleitet und können am Document Objekt abgefangen 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

Browser-Kompatibilität