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, der den DOM-Baum darstellt.

Der DOM-Baum umfasst Elemente wie <body> und <table>, neben vielen anderen. Er bietet globale Funktionalität für das Dokument, wie z. B. 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 jegliche Art von Dokumenten. Abhängig vom Dokumenttyp (z. B. HTML, XML, SVG, …) steht eine umfassendere API zur Verfügung: HTML-Dokumente, die mit dem MIME-Typ "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 momentan den Fokus hat.
Document.activeViewTransition Schreibgeschützt Experimentell: Gibt eine ViewTransition-Instanz zurück, die den aktuell aktiven View-Übergang im Dokument repräsentiert, oder null, wenn kein aktiver View-Übergang vorliegt.
Document.adoptedStyleSheets: Fügt ein Array konstruierter Stylesheets hinzu, die vom Dokument verwendet werden. Diese Stylesheets können auch mit Schatten-DOM-Subtrees desselben Dokuments geteilt werden.
Document.body: Gibt den Knoten <body> oder <frameset> 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: 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 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 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 das FeaturePolicy-Interface mit den auf das Dokument angewandten Funktionsrichtlinien 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.
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 in 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 ist, während der Zeiger gesperrt ist. null, wenn die Sperre aussteht, der Zeiger entsperrt ist oder wenn das Ziel in einem anderen Dokument liegt.
Document.prerendering Schreibgeschützt Experimentell: Gibt ein Boolean zurück, das 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 eingebunden oder darin 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 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 ist für solche Dokumente erweitert.

Document.cookie

Gibt eine Liste der Cookies für dieses Dokument zurück, getrennt durch Semikolon, oder setzt ein einzelnes Cookie.

Document.defaultView Schreibgeschützt

Gibt eine Referenz auf das Fensterobjekt zurück.

Document.designMode

Ruft die Möglichkeit ab oder setzt diese, das gesamte Dokument zu bearbeiten.

Document.dir

Ruft die Richtung (rtl/ltr) des Dokuments ab oder setzt diese.

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 erhält den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt den Dokumentstandort als Zeichenkette zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften offengelegt:

Für jedes <embed>, <form>, <iframe>, <img> und <object>-Element wird dessen 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 auf dieses Element zurück.
Für jedes <object>-Element wird dessen id (wenn nicht leer) exponiert.
Für jedes <img>-Element mit nicht leerem name wird dessen id (wenn 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 von ihnen enthält.

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe aktiver Links im Dokumentenkörper zurück oder setzt diese.
Document.all Veraltet: Bietet Zugriff auf alle Elemente im Dokument — es gibt eine HTMLAllCollection zurück, die an den Dokumentknoten gebunden 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. Eine 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 setzt diese.
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 setzt diese.
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 von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt den Namen des zuletzt aktivierten Stylesheets-Sets zurück. Hat den Wert null, bis das Stylesheet durch das Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet: Ruft die Farbe der Hyperlinks im Dokument ab oder setzt diese.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt das bevorzugte Stylesheet-Set zurück, wie es vom Seitenautor festgelegt 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 im Dokument verfügbaren Stylesheet-Sets zurück.
Document.vlinkColor Veraltet: Ruft die Farbe von besuchten Hyperlinks ab oder setzt diese.
Document.xmlEncoding Veraltet: Gibt die Kodierung zurück, wie sie durch die XML-Deklaration bestimmt wurde.
Document.xmlStandalone Veraltet: Gibt true zurück, wenn in der XML-Deklaration das Dokument als eigenständig angegeben 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 ein 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 Textzeichenkette 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 jeder der letzten drei Epochen. Standardmäßig veranlasst die Methode auch, dass der Browser den aktuellen Seitenbesuch wie vom Anrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung 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 mit der Einfügemarke und den Zeichenoffset der Einfügemarke innerhalb dieses Knotens enthält.
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 gegebenen 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 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 den Vollbildmodus des Vollbildelements des Dokuments.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster und gibt es in seinen ursprünglichen Container zurück.
Document.exitPointerLock(): Hebt die Zeigersperre auf.
Document.getAnimations(): Gibt ein Array von allen Animation-Objekten zurück, die aktuell in Kraft sind und deren Ziel-Elemente Nachkommen des documents sind.
Document.getBoxQuads() Experimentell: Gibt eine Liste von DOMQuad-Objekten zurück, die die CSS-Teile des Knotens repräsentieren.
Document.getElementById(): Gibt eine Objektreferenz auf das identifizierte 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 vom Benutzer ausgewählten Textbereich darstellt oder die aktuelle Position des Cursors.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem boolean-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(): Verschiebt einen gegebenen Node innerhalb des Dokuments-DOM-Knotens als direktes Kind, vor einem gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann einzusetzen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht es, 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 den ersten Elementknoten innerhalb des Dokuments in Dokumentreihenfolge zurück, der die angegebenen Selektoren erfüllt.
Document.querySelectorAll(): Gibt eine Liste aller Elementknoten innerhalb des Dokuments zurück, die die angegebenen Selektoren erfüllen.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Mausaufnahme 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 angegebene neue Menge von Kindern.
Document.requestStorageAccess(): Erlaubt einem Dokument, das in einem Drittanbieter-Kontext geladen wurde (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 durch Websites im Drittanbieter-Kontext blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Erlaubt Top-Level-Seiten, Drittanbieter-Cookies im Auftrag von eingebetteten Inhalten anzufordern, die von einer anderen Seite im gleichen verwandten Website-Set stammen.
Document.startViewTransition(): Startet einen neuen View-Übergang und gibt ein ViewTransition-Objekt zurück, um ihn zu repräsentieren.

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 ist für solche Dokumente erweitert:

Document.clear() Veraltet: Diese Methode tut nichts.
Document.close(): Schließt einen Dokumentstream zum Schreiben.
Document.execCommand() Veraltet: Führt auf einem editierbaren 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 innerhalb des spezifizierten Dokuments befindet.
Document.open(): Öffnet einen Dokumentstream 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

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 Bereinigung.
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 durch addEventListener() oder durch Zuweisung eines Ereignis-Listeners zu der oneventname-Eigenschaft dieses Interfaces. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten im Dokumentbaum heraufblasen.

afterscriptexecute Nicht standardisiert Veraltet: Ausgelöst, wenn ein statisches <script>-Element sein Skript fertig ausgeführt hat.
beforescriptexecute Nicht standardisiert Veraltet: Ausgelöst, wenn ein statisches <script> im Begriff ist, mit der Ausführung zu beginnen.
prerenderingchange Experimentell: Ausgelöst bei einem vorab gerenderten Dokument, wenn es aktiviert wird (d.h. der Benutzer die Seite ansieht).
securitypolicyviolation: Ausgelöst, wenn eine Content-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Ausgelöst, wenn der Inhalt eines Tabs sichtbar geworden ist oder verborgen wurde.

Vollbild-Ereignisse

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

Lade- & Entlade-Ereignisse

DOMContentLoaded: Ausgelöst, wenn das Dokument vollständig geladen und analysiert wurde, ohne darauf zu warten, dass Stylesheets, Bilder und Unterrahmen das Laden abschließen.
readystatechange: Ausgelöst, wenn sich das readyState-Attribut eines Dokuments geändert hat.

Ereignisse der Zeigersperre

pointerlockchange: Ausgelöst, wenn der Zeiger gesperrt/entsperrt wird.
pointerlockerror: Ausgelöst, wenn die Zeigersperre fehlgeschlagen ist.

Scroll-Ereignisse

scroll: Ausgelöst, wenn das Dokumentfeld oder ein Element gescrollt wurde.
scrollend: Ausgelöst, wenn das Dokumentfeld oder ein Element das Scrollen abgeschlossen hat.
scrollsnapchange Experimentell: Ausgelöst über dem Scroll-Container am Ende einer Scroll-Operation, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell: Ausgelöst über dem Scroll-Container, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahl-Ereignisse

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

Geblähte Ereignisse

Nicht alle Ereignisse, die bis zum Dokument-Objekt blasen, können es erreichen. Nur die folgenden tun es und können am Dokument-Objekt belauscht 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