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 beinhaltet Elemente wie <body> und <table>, neben vielen anderen. Er bietet globale Funktionalitäten für das Dokument, wie den Erhalt der URL der Seite und das Erstellen neuer Elemente im Dokument.

Das Document-Interface beschreibt die gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Dokumententyp (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 ein Array von konstruierten Stylesheets hinzu, die vom Dokument verwendet werden sollen. Diese Stylesheets können auch mit Unterbäumen des Shadow DOM 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 derzeit 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 den Dokumentenstandort als Zeichenkette zurück.
Document.embeds Schreibgeschützt: Gibt ein 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-Richtlinien 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 ein 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 derzeit im Vollbildmodus für dieses Dokument dargestellt wird.
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 angesehen wird oder nicht.
Document.images Schreibgeschützt: Gibt ein 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.
Document.links Schreibgeschützt: Gibt ein 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 ein 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 das Ziel in einem anderen Dokument ist.
Document.prerendering Schreibgeschützt Experimentell: Gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prozess des Vorabladens ist, wie über die Speculation Rules API initiiert.
Document.scripts Schreibgeschützt: Gibt ein HTMLCollection der <script>-Elemente im Dokument zurück.
Document.scrollingElement Schreibgeschützt: Gibt einen Verweis auf das Element zurück, das das Dokument scrollt.
Document.styleSheets Schreibgeschützt: Gibt eine StyleSheetList von CSSStyleSheet-Objekten zurück, die für Stylesheets explizit mit oder in ein Dokument eingebunden sind.
Document.timeline Schreibgeschützt: Gibt eine 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 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 einen Verweis auf das Fensterobjekt zurück.

Document.designMode

Ermöglicht das Abrufen/Einstellen der Bearbeitungsmöglichkeit für das gesamte Dokument.

Document.dir

Ermöglicht das Abrufen/Einstellen 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 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 holt den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt den Dokumentenstandort als Zeichenkette zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften herausgestellt:

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

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

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe der aktiven Links im Dokumentbody zurück oder setzt diese.
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. Alte Eigenschaft, die die Liste der Applets innerhalb eines Dokuments zurückgab.
Document.bgColor Veraltet: Holt/Setzt die Hintergrundfarbe des aktuellen Dokuments.
Document.charset Veraltet Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie diese Eigenschaft stattdessen.
Document.domain Veraltet: Holt/Setzt die Domain des aktuellen Dokuments.
Document.fgColor Veraltet: Holt/Setzt die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments.
Document.fullscreen Veraltet: Gibt true zurück, wenn das Dokument im Vollbildmodus ist.
Document.inputEncoding Veraltet Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie diese Eigenschaft stattdessen.
Document.lastStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt den Namen der zuletzt aktivierten Stylesheet-Gruppe zurück. Hat den Wert null, bis das Stylesheet geändert wird, indem der Wert von selectedStyleSheetSet gesetzt wird.
Document.linkColor Veraltet: Holt/Setzt die Farbe der Hyperlinks im Dokument.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt die bevorzugte Stylesheet-Gruppe zurück, wie vom Seitenautor angegeben.
Document.rootElement Veraltet: Wie Document.documentElement, aber nur für <svg>-Wurzelelemente. Verwenden Sie diese Eigenschaft stattdessen.
Document.selectedStyleSheetSet Veraltet Nicht standardisiert: Gibt zurück, welche Stylesheet-Gruppe derzeit verwendet wird.
Document.styleSheetSets Veraltet Schreibgeschützt Nicht standardisiert: Gibt eine Liste der Stylesheet-Gruppen zurück, die im Dokument verfügbar sind.
Document.vlinkColor Veraltet: Holt/Setzt die Farbe der besuchten Hyperlinks.
Document.xmlEncoding Veraltet: Gibt die Kodierung zurück, wie sie in der XML-Deklaration angegeben ist.
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 sie in der XML-Deklaration angegeben ist, oder "1.0", wenn die Deklaration fehlt.

Instanz-Methoden

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.adoptNode(): Übernimmt einen Knoten aus einem externen Dokument.
Document.append(): Fügt eine Menge von Node-Objekten oder Zeichenketten nach dem letzten Kind des Dokuments ein.
Document.ariaNotify() Experimentell Nicht standardisiert: Gibt an, dass eine bestimmte Zeichenkette von einem Bildschirmlesegerät angekündigt werden sollte.
Document.browsingTopics() Experimentell Nicht standardisiert: Gibt ein Promise zurück, das mit einem Array von Objekten gefüllt wird, die die wichtigsten Themen für den Benutzer darstellen, eines aus jedem der letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Anrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in die Berechnung der Themen einbezogen werden kann. Weitere Details finden Sie in der Topics API.
Document.captureEvents() Veraltet: Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition-Objekt zurück, das den DOM-Knoten enthält, der den Cursor enthält, und den Zeichenoffset des Cursors innerhalb dieses Knotens.
Document.caretRangeFromPoint() Nicht standardisiert: Holt ein Range-Objekt für das Dokumentfragment an den angegebenen Koordinaten.
Document.createAttribute(): Erstellt ein neues Attr-Objekt und gibt es zurück.
Document.createAttributeNS(): Erstellt einen neuen Attributknoten in einem bestimmten Namensraum und gibt ihn zurück.
Document.createCDATASection(): Erstellt einen neuen CDATA-Knoten und gibt ihn zurück.
Document.createComment(): Erstellt einen neuen Kommentar-Knoten 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 die angegebene Stylesheet-Gruppe.
Document.exitFullscreen(): Stellt das dokumentweite Vollbild-Element nicht mehr im Vollbildmodus dar.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock(): Löst die Zeigersperre.
Document.getAnimations(): Gibt ein Array aller momentan in Effekt befindlichen 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 repräsentieren.
Document.getElementById(): Gibt einen Objektverweis 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 Textes oder die aktuelle Position des Cursors repräsentiert.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem booleschen Wert aufgelöst wird, der anzeigt, 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 im Document DOM-Knoten als direktes Kind vor einen gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann wieder einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht Ihnen, das Element zu ändern, das als Hintergrundbild für eine bestimmte Element-ID verwendet wird.
Document.prepend(): Fügt eine Menge von Node-Objekten oder Zeichenketten vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt das erste Elementknoten im Dokument, in Dokumentreihenfolge, zurück, das 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: Löst die aktuelle Maus-Capture, 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 eine angegebene neue Menge von Kindern.
Document.requestStorageAccess(): Ermöglicht es einem Dokument, das in einem Drittanbieter-Kontext geladen wurde (z.B. eingebettet in ein <iframe>), Zugriff auf unpartitionierte Cookies zu beantragen, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies durch Seiten blockieren, die in einem Drittanbieter-Kontext geladen wurden, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Ermöglicht es obersten Websites, Cookie-Zugriff auf Drittanbieter-Ebene im Namen von eingebettetem Inhalt zu beantragen, der von einer anderen Website im selben zusammengehörigen Website-Set stammt.
Document.startViewTransition(): Startet einen neuen Ansichtstransition und gibt ein ViewTransition-Objekt zurück, das diese 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(): Wertet einen XPath-Ausdruck aus.

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 macht nichts.
Document.close(): Schließt einen Dokumentstream zum 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 innerhalb des angegebenen Dokuments liegt.
Document.open(): Öffnet einen Dokumentstream zum Schreiben.
Document.queryCommandEnabled() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl für den aktuellen Bereich ausgeführt werden kann.
Document.queryCommandIndeterm() Veraltet: Gibt true zurück, wenn sich der Formatierungsbefehl in einem unbestimmten Zustand im aktuellen Bereich befindet.
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() Experimentell: Erstellt ein neues Document-Objekt aus einer HTML-Zeichenkette auf eine XSS-sichere Weise mit Sanitärmaßnahmen.
Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenkette, ohne eine Sanitärprüfung durchzuführen. Die Zeichenkette kann deklarative Shadow-Root enthalten.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() ab oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Neben den unten aufgeführten Ereignissen können viele Ereignisse von Knoten im Dokumentbaum aufkommen.

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script>-Element seine Skriptausführung beendet hat.
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> anfangen soll, ausgeführt zu werden.
prerenderingchange Experimentell: Wird auf einem vorgerenderten Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite ansieht).
securitypolicyviolation: Wird ausgelöst, wenn eine Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar oder versteckt wurde.

Vollbildereignisse

fullscreenchange: Wird ausgelöst, wenn Document in den Vollbildmodus übergeht 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 Entladeereignisse

DOMContentLoaded: Wird ausgelöst, wenn das Dokument vollständig geladen und geparst wurde, ohne auf das Laden von Stylesheets, Bildern und Unterframes zu warten.
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 die Zeigersperre fehlschlägt.

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn die Dokumentenansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Scrollen der Dokumentenansicht oder eines Elements abgeschlossen ist.
scrollsnapchange Experimentell: Wird am Scroll-Container am Ende eines Scroll-Vorgangs 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 bestimmt, 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.

Geschachtelte Ereignisse

Nicht alle geschachtelten Ereignisse 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

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