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.

Das Document-Interface steht für jede Webseite, die im Browser geladen wird, und dient als Einstiegsquelle für den Inhalt der Webseite, was der DOM-Baum ist.

Der DOM-Baum umfasst Elemente wie <body> und <table>, unter vielen anderen. Es bietet global Funktionen 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 allgemeinen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Dokumenttyp (z. B. HTML, XML, SVG, …) steht eine größere API zur Verfügung: HTML-Dokumente, die mit dem Inhaltstyp "text/html" ausgeliefert werden, implementieren zusätzlich 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 aktuell den Fokus hat.
Document.adoptedStyleSheets:
- Fügt dem Dokument ein Array von erstellten Stylesheets hinzu. Diese Stylesheets können auch mit Shadow-DOM-Subtrees 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 im 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 aus dem MIME-Header des aktuellen Dokuments zurück.
Document.currentScript Schreibgeschützt:
- Gibt das <script>-Element zurück, dessen Script gerade 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 Kind des Dokuments ist. Bei HTML-Dokumenten ist dies normalerweise das HTMLHtmlElement-Objekt, das das <html>-Element des Dokuments repräsentiert.
Document.documentURI Schreibgeschützt:
- Gibt den Speicherort des Dokuments 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-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 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 derzeit im Vollbildmodus für dieses Dokument angezeigt wird.
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 angesehen wird oder nicht.
Document.images Schreibgeschützt:
- Gibt eine HTMLCollection der Bilder im Dokument zurück.
Document.implementation Schreibgeschützt:
- Gibt die DOM-Implementierung zurück, die mit dem aktuellen Dokument verbunden ist.
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 true 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 wurde, während der Zeiger gesperrt ist. null, wenn die Sperre aussteht, der Zeiger entsperrt ist oder das Ziel sich in einem anderen Dokument befindet.
Document.prerendering Schreibgeschützt Experimentell :
- Gibt einen Boolean zurück, der angibt, ob das Dokument sich aktuell im Prozess des Prerendings befindet, wie es über die Speculation Rules API initiiert wurde.
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 eine Timeline als spezielle Instanz von DocumentTimeline zurück, die automatisch beim Laden der Seite erstellt wird.
Document.visibilityState Schreibgeschützt:
- Gibt eine string zurück, die den Sichtbarkeitszustand des Dokuments bezeichnet. Mögliche Werte sind visible, hidden, prerender 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 Fenster-Objekt zurück.
Document.designMode:
- Ruft die Möglichkeit ab/legt fest, das gesamte Dokument zu bearbeiten.
Document.dir:
- Ruft die Richtung (rtl/ltr) des Dokuments ab/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 auf diese Seite verlinkt hat.
Document.title:
- Setzt oder ruft den Titel des aktuellen Dokuments ab.
Document.URL Schreibgeschützt:
- Gibt den Speicherort des Dokuments als Zeichenfolge zurück.

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 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/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/setzt diese.
Document.fgColor Veraltet :
- Ruft die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments ab/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 Style Sheet Sets zurück. Hat den Wert null, bis das Style Sheet durch Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet :
- Ruft die Farbe der Hyperlinks im Dokument ab/setzt diese.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert :
- Gibt das bevorzugte Style Sheet Set zurück, wie es vom Seitenautor angegeben wurde.
Document.rootElement Veraltet :
- Ähnlich wie Document.documentElement, jedoch nur für <svg>-Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet Veraltet Nicht standardisiert :
- Gibt zurück, welches Style Sheet Set derzeit verwendet wird.
Document.styleSheetSets Veraltet Schreibgeschützt Nicht standardisiert :
- Gibt eine Liste der auf dem Dokument verfügbaren Style Sheet Sets zurück.
Document.vlinkColor Veraltet :
- Ruft die Farbe besuchter Hyperlinks ab/setzt diese.
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., ein externer Teil der DTD beeinflusst den Dokumentinhalt), andernfalls false.
Document.xmlVersion Veraltet :
- Gibt die Versionsnummer, wie in der XML-Deklaration angegeben, zurück oder "1.0", falls die Deklaration fehlt.

Instanzmethoden

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 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 Top-Themen für den Benutzer darstellen, eines aus jeder der letzten drei Epochen. Standardmäßig lässt die Methode den Browser auch den aktuellen Seitenbesuch als vom Anrufer beobachtet aufzeichnen, so dass 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 und den Zeichenversatz des Cursors 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 Kommentar-Knoten und gibt ihn zurück.
Document.createDocumentFragment():
- Erstellt ein neues Document Fragment.
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 Style Sheet Set.
Document.exitFullscreen():
- Beendet die Darstellung des Vollbild-Elements des Dokuments im Vollbildmodus.
Document.exitPictureInPicture():
- Entfernen Sie das Video aus dem schwebenden Bild-im-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock():
- Hebt die Sperrung des Zeigers auf.
Document.getAnimations():
- Gibt ein Array aller Animation-Objekte zurück, die derzeit in Kraft sind und deren Zielelemente Nachkommen des Documents 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 der Elemente mit dem angegebenen Klassennamen zurück.
Document.getElementsByTagName():
- Gibt eine Liste der Elemente mit dem angegebenen Tag-Namen zurück.
Document.getElementsByTagNameNS():
- Gibt eine Liste der Elemente mit dem angegebenen Tag-Namen und Namespace zurück.
Document.getSelection():
- Gibt ein Selection-Objekt zurück, das den vom Benutzer ausgewählten Textrange oder die aktuelle Position des Cursors darstellt.
Document.hasStorageAccess():
- Gibt ein Promise zurück, das mit einem Boolean-Wert erfüllt wird, 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.mozSetImageElement() Nicht standardisiert :
- Ermöglicht es 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 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 :
- Hebt die derzeitige Mausaufnahme auf, 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 spezifizierte neue Menge von Kindern.
Document.requestStorageAccess():
- Ermöglicht einem Dokument, das in einem Drittanbieterkontext geladen wurde (d.h. eingebettet in ein <iframe>), Zugriff auf unpartitionierte Cookies zu beantragen, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies durch Websites in einem Drittanbieterkontext blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell :
- Ermöglicht es Top-Level-Sites, Drittanbieter-Cookie-Zugriff im Namen von eingebetteten Inhalten zu beantragen, die von einer anderen Seite innerhalb desselben verwandten Website-Sets stammen.
Document.startViewTransition():
- Startet einen neuen Ansichtsübergang 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 Dokument-Stream für das Schreiben.
Document.execCommand() Veraltet :
- Führt auf einem editierbaren Dokument einen Formatierungsbefehl aus.
Document.getElementsByName():
- Gibt eine Liste der Elemente 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 Dokument-Stream 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():
- Schreibt eine Zeile Text in ein Dokument.

Statische Methoden

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.parseHTMLUnsafe():
- Erstellt ein neues Document-Objekt aus einem HTML-String ohne Durchführung von Sanitärmaßnahmen. Der String kann deklarative Shadow-Roots enthalten.

Ereignisse

Diese Ereignisse können mit addEventListener() abgehört oder durch Zuweisen eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces überwacht werden. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Nodes im Dokumentbaum aufsteigen.

afterscriptexecute Nicht standardisiert Veraltet :
- Wird ausgelöst, wenn ein statisches <script>-Element die Ausführung seines Scripts abgeschlossen hat.
beforescriptexecute Nicht standardisiert Veraltet :
- Wird ausgelöst, wenn ein statisches <script>-Element kurz vor der Ausführung steht.
prerenderingchange Experimentell :
- Wird bei einem prerendered Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite einsehen kann).
securitypolicyviolation:
- Wird ausgelöst, wenn eine Content Security Policy verletzt wird.
visibilitychange:
- Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wird oder verborgen wird.

Zwischenablage-Ereignisse

copy:
- Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert.
cut:
- Wird ausgelöst, wenn der Benutzer eine Ausschneiden-Aktion über die Benutzeroberfläche des Browsers initiiert.
paste:
- Wird ausgelöst, wenn der Benutzer eine Einfügen-Aktion über die Benutzeroberfläche des Browsers initiiert.

Vollbild-Ereignisse

fullscreenchange:
- Wird ausgelöst, wenn das Document in den Vollbildmodus ein- oder austritt.
fullscreenerror:
- Wird ausgelöst, wenn ein Fehler beim Versuch, in den Vollbildmodus zu wechseln oder ihn zu verlassen, auftritt.

Laden & Entladen-Ereignisse

DOMContentLoaded:
- Wird ausgelöst, wenn das Dokument vollständig geladen und analysiert wurde, ohne darauf zu warten, dass Stylesheets, Bilder und Subframes das Laden abgeschlossen haben.
readystatechange:
- Wird ausgelöst, wenn das readyState-Attribut eines Dokuments geändert wurde.

Zeiger-Sperr-Ereignisse

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

Scroll-Ereignisse

scroll:
- Wird ausgelöst, wenn die Dokumentenansicht oder ein Element gescrollt wurde.
scrollend:
- Wird ausgelöst, wenn die Dokumentenansicht oder ein Element das Scrollen beendet hat.
scrollsnapchange Experimentell :
- Wird auf dem Scroll-Container am Ende einer Scroll-Operation ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell :
- Wird auf dem Scroll-Container ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel ansteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.

Auswahl-Ereignisse

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

Gebubblete Ereignisse

Nicht alle Ereignisse, die im Dokument aufsteigen, können das Document-Objekt erreichen. Nur die folgenden können auf dem 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