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 repräsentiert jede im Browser geladene Webseite und dient als Einstiegspunkt in den Inhalt der Webseite, welcher der DOM-Baum ist.

Der DOM-Baum umfasst Elemente wie <body> und <table> sowie viele andere. Es bietet global Funktionen für das Dokument, beispielsweise wie man die URL der Seite erhält und neue Elemente im Dokument erstellt.

Das Document-Interface beschreibt die gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Dokumenttyp (z. B. HTML, XML, SVG, …) ist eine umfangreichere API verfügbar: 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.

Instanzeigenschaften

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 ein Array von konstruierten Stylesheets hinzu, die vom Dokument verwendet werden sollen. Diese Stylesheets können auch mit Schatten-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 Content-Type vom MIME-Header des aktuellen Dokuments zurück.
Document.currentScript Schreibgeschützt: Gibt das <script>-Element zurück, dessen Skript gerade verarbeitet wird und kein JavaScript-Modul ist.
Document.doctype Schreibgeschützt: Gibt die Dokumenttypdefinition (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 die Dokumentposition 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 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 das 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 Boolean-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 verknüpfte 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-in-Bild-Modus in diesem Dokument präsentiert wird.
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 gesetzt wurde, während der Zeiger gesperrt ist. null, wenn die Sperre aussteht, der Zeiger entsperrt ist oder 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 Rahmen der Speculation Rules API prerendert wird.
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 Timeline als spezielle Instanz von DocumentTimeline zurück, die beim Laden der Seite automatisch erstellt wird.
Document.visibilityState Schreibgeschützt: Gibt eine string-Darstellung des Sichtbarkeitszustands des Dokuments zurück. 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 Semikolons 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

Ermöglicht das Bearbeiten des gesamten Dokuments zu erhalten oder zu setzen.

Document.dir

Ruft die Direktionalität (rtl/ltr) des Dokuments ab oder legt sie 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 auf diese Seite verlinkt hat.

Document.title

Setzt oder erhält den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt die Dokumentposition 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 sein name (wenn nicht leer) exponiert. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann gibt document["my_form"] (und das Äquivalent document.my_form) eine Referenz zu diesem Element zurück.
Für jedes <object>-Element wird seine id (wenn nicht leer) exponiert.
Für jedes <img>-Element mit nicht leerem name wird seine id (wenn nicht leer) exponiert.

Wenn eine Eigenschaft einem einzigen 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 Dokumentkörper zurück oder setzt diese.
Document.all Veraltet: Bietet Zugriff auf alle Elemente im Dokument — gibt eine HTMLAllCollection zurück, die beim Dokumentsknoten wurzelt. 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 innerhalb eines Dokuments zurückgab.
Document.bgColor Veraltet: Ruft die Hintergrundfarbe des aktuellen Dokuments ab oder legt sie fest.
Document.charset Veraltet Schreibgeschützt: Alias von 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 die Textfarbe des aktuellen Dokuments ab oder legt sie 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 Stylesheet-Sets zurück. Hat den Wert null, bis das Stylesheet durch Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet: Ruft die Farbe der Hyperlinks im Dokument ab oder legt sie fest.
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: Ruft die Farbe der besuchten Hyperlinks ab oder legt sie fest.
Document.xmlEncoding Veraltet: Gibt die Kodierung zurück, wie sie 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. 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

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.adoptNode(): Nimmt einen Knoten aus einem externen Dokument an.
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 eine bestimmte Zeichenfolge von einem Screenreader angesagt werden soll.
Document.browsingTopics() Experimentell Nicht standardisiert: Gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die die wichtigsten Themen für den Benutzer repräsentieren, eines aus jedem der letzten drei Epochen. Standardmäßig verursacht die Methode auch, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in der Berechnung der Themen verwendet werden 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 enthält, der das Caret enthält, und den Zeichen-Offset des Carets innerhalb dieses Knotens.
Document.caretRangeFromPoint() Nicht standardisiert: Ruft ein Range-Objekt für das Dokumentfragment unter den angegebenen Koordinaten ab.
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 gegebenen 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 eine TouchList.
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 Vollbildanzeige des Vollbild-Elements des Dokuments.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück zu seinem ursprünglichen Container.
Document.exitPointerLock(): Gibt die Zeiger-Sperre frei.
Document.getAnimations(): Gibt ein Array aller aktuell wirksamen Animationen (Animation-Objekte) zurück, deren Zielelemente Nachkommen 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 zum identifizierten Element zurück.
Document.getElementsByClassName(): Gibt eine Liste von Elementen mit dem gegebenen Klassennamen zurück.
Document.getElementsByTagName(): Gibt eine Liste von Elementen mit dem gegebenen Tag-Namen zurück.
Document.getElementsByTagNameNS(): Gibt eine Liste von Elementen mit dem gegebenen Tag-Namen und Namespace zurück.
Document.getSelection(): Gibt ein Selection-Objekt zurück, das den von den Benutzern ausgewählten Textbereich oder die aktuelle Position des Carets repräsentiert.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem Boolean-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(): Verschiebt einen gegebenen Node innerhalb des Document-DOM-Knotens als direktes Kind vor einen gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht 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 das erste Elementknoten innerhalb des Dokuments zurück, das in Dokumentreihenfolge den angegebenen Selektoren entspricht.
Document.querySelectorAll(): Gibt eine Liste aller Elemente im Dokument zurück, die den angegebenen Selektoren entsprechen.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Maus-Erfassung frei, wenn sie sich auf einem Element in diesem Dokument befindet.
Document.releaseEvents() Veraltet: Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die vorhandenen Kinder eines Dokuments durch einen angegebenen neuen Satz von Kindern.
Document.requestStorageAccess(): Ermöglicht einem Dokument, das in einem Drittparteikontext geladen wurde (d.h. eingebettet in einem <iframe>) ist, Zugriff auf nicht partitionierte Cookies anzufordern, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf nicht partitionierte Cookies von in einem Drittparteikontext geladenen Seiten blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Erlaubt Websites auf oberster Ebene, Drittpartei-Cookie-Zugriff im Namen von eingebettetem Inhalt zu beantragen, der von einer anderen Website im selben verwandten Website-Set stammt.
Document.startViewTransition(): Startet einen neuen Ansichtsübergang und gibt ein ViewTransition-Objekt zurück, das ihn darstellt.

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 Dokumentenstrom 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 gegebenen Namen zurück.
Document.hasFocus(): Gibt true zurück, wenn sich der Fokus derzeit irgendwo im angegebenen Dokument befindet.
Document.open(): Öffnet einen Dokumentenstrom 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 in einer XSS-sicheren Weise mit Sanitärverfahren.
Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einem HTML-String ohne Durchführung von Sanitärverfahren. Der String kann deklarative Shadow Roots enthalten.

Ereignisse

Sie können diesen Ereignissen mit addEventListener() zuhören oder einen Ereignis-Listener auf die oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten im Dokumentbaum aufsteigen.

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script>-Element das Ausführen seines Skripts beendet.
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> im Begriff ist, mit dem Ausführen zu beginnen.
prerenderingchange Experimentell: Wird bei einem prerenderten Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite ansieht).
securitypolicyviolation: Wird ausgelöst, wenn eine Content-Security-Policy verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar oder verborgen geworden ist.

Vollbild-Ereignisse

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

Lade- und Entladeereignisse

DOMContentLoaded: Wird ausgelöst, wenn das Dokument vollständig geladen und analysiert wurde, ohne auf das Laden von Stylesheets, Bildern und Iframes zu warten.
readystatechange: Wird ausgelöst, wenn sich das Attribut readyState 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 fehlschlägt.

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn die Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn die Dokumentansicht oder ein Element das Scrollen abgeschlossen hat.
scrollsnapchange Experimentell: Wird am Scroll-Container am Ende einer Scroll-Operation ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell: Wird am Scroll-Container ausgelöst, wenn der Browser ein neues Scroll-Snap-Ziel ermittelt, das ausgewählt wird, wenn die aktuelle Scroll-Geste endet.

Auswahl-Ereignisse

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

Ereignisse, die aufsteigen

Nicht alle aufsteigenden Ereignisse können das Document-Objekt erreichen. Die folgenden Ereignisse tun dies und können auf dem 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

Browser-Kompatibilität

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden