Dokument

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Das Document Interface repräsentiert jede Webseite, die im Browser geladen ist, 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. Er bietet global Funktionalitäten für das Dokument, wie beispielsweise das Abrufen der URL der Seite und das Erstellen neuer Elemente im Dokument.

Das Document Interface beschreibt die allgemeinen Eigenschaften und Methoden für jede Art von Dokument. Je nach Dokumenttyp (z.B. HTML, XML, SVG, …) steht eine größere 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.

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.activeViewTransition Schreibgeschützt: Gibt eine ViewTransition Instanz zurück, die die aktuell aktive View Transition im Dokument repräsentiert, oder null, wenn keine aktive View Transition vorhanden ist.
Document.adoptedStyleSheets: Fügt ein Array von konstruierten Stylesheets hinzu, das vom Dokument verwendet werden soll. Diese Stylesheets können auch mit Shadow-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 aus dem 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.customElementRegistry Schreibgeschützt: Das CustomElementRegistry Objekt, das mit diesem Dokument assoziiert ist, oder null, wenn keines gesetzt wurde.
Document.doctype Schreibgeschützt: Gibt die Dokumenttyp-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 Zeichenkette zurück.
Document.embeds Schreibgeschützt: Gibt eine HTMLCollection der eingebetteten <embed> Elemente im Dokument zurück.
Document.featurePolicy 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 derzeit im Vollbildmodus für dieses Dokument ist.
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 gilt 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 dem aktuellen Dokument zugeordnet 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-in-Bild-Modus in diesem Dokument dargestellt wird.
Document.pictureInPictureEnabled Schreibgeschützt: Gibt true zurück, wenn das Bild-in-Bild-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 Sperrung aussteht, der Zeiger entsperrt ist oder das Ziel in einem anderen Dokument ist.
Document.prerendering Schreibgeschützt: Gibt einen Boolean zurück, der anzeigt, ob das Dokument derzeit im Prozess des Vorrenders ist, wie über die Speculation Rules API eingeleitet.
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 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 Sichtbarkeitszustand 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 eine Referenz auf das Fensterobjekt zurück.

Document.designMode

Erhält/legt die Fähigkeit fest, das gesamte Dokument zu bearbeiten.

Document.dir

Erhält/legt die Richtung (rtl/ltr) des Dokuments 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 den Speicherort des Dokuments als Zeichenkette zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften freigelegt:

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

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

Veraltete Eigenschaften

Document.alinkColor: Gibt die Farbe der aktiven Links im Dokumentkörper zurück oder setzt sie fest.
Document.all: 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 Schreibgeschützt: Gibt eine Liste aller Anker im Dokument zurück.
Document.applets 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: Erhält/legt die Hintergrundfarbe des aktuellen Dokuments fest.
Document.charset Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain: Erhält/legt die Domain des aktuellen Dokuments fest.
Document.fgColor: Erhält/legt die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments fest.
Document.fullscreen: Gibt true zurück, wenn das Dokument im Fullscreen-Modus ist.
Document.inputEncoding Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Schreibgeschützt: Gibt den Namen des Stylesheet-Sets zurück, das zuletzt aktiviert wurde. Hat den Wert null, bis das Stylesheet durch Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor: Erhält/legt die Farbe der Hyperlinks im Dokument fest.
Document.preferredStyleSheetSet Schreibgeschützt: Gibt das bevorzugte Stylesheet-Set zurück, wie es vom Seitenautor festgelegt wurde.
Document.rootElement: Ähnlich wie Document.documentElement, aber nur für <svg> Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet: Gibt zurück, welches Stylesheet-Set derzeit verwendet wird.
Document.styleSheetSets Schreibgeschützt: Gibt eine Liste der Stylesheet-Sets zurück, die im Dokument verfügbar sind.
Document.vlinkColor: Erhält/legt die Farbe der besuchten Hyperlinks fest.
Document.xmlEncoding: Gibt die Kodierung zurück, wie sie in der XML-Deklaration bestimmt wurde.
Document.xmlStandalone: Gibt true zurück, wenn die XML-Deklaration das Dokument als eigenständig spezifiziert (z.B., Ein externer Teil der DTD beeinflusst den Inhalt des Dokuments), andernfalls false.
Document.xmlVersion: 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 Zeichenketten nach dem letzten Kind des Dokuments ein.
Document.ariaNotify(): Gibt an, dass ein bestimmter Text von einem Screenreader angesagt werden soll.
Document.browsingTopics(): Gibt ein Versprechen zurück, das mit einem Array von Objekten erfüllt wird, die die wichtigsten Themen für den Benutzer darstellen, jeweils eines aus den letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Anrufer beobachtet aufzeichnet, so dass der Hostname der Seite später in der Themenberechnung verwendet werden kann. Siehe die Topics API für mehr Details.
Document.captureEvents(): Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition Objekt zurück, das den DOM-Knoten und den Zeichenoffset des Cursors innerhalb dieses Knotens enthält.
Document.caretRangeFromPoint(): Ruft ein Range Objekt für den 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 angegebenen 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 dem Namespace-URI.
Document.createEvent(): 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(): Erstellt ein Touch Objekt.
Document.createTouchList(): 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(): Aktiviert die Stylesheets für das angegebene Stylesheet-Set.
Document.exitFullscreen(): Beendet die Anzeige des Vollbild-Elements des Dokuments im Vollbildmodus.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück zu seinem ursprünglichen Container.
Document.exitPointerLock(): Löst die Zeigersperre.
Document.getAnimations(): Gibt ein Array aller Animation Objekte zurück, die derzeit in Kraft sind, deren Zielelemente Nachkommen des Dokuments sind.
Document.getBoxQuads(): Gibt eine Liste von DOMQuad Objekten zurück, die die CSS-Fragmente des Knotens repräsentieren.
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 Namensraum 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.hasPrivateToken(): Gibt ein Versprechen zurück, das mit einem Boolean-Wert erfüllt wird, der angibt, ob der Browser ein privater Zustandstoken von einem bestimmten Anbieter gespeichert hat.
Document.hasRedemptionRecord(): Gibt ein Versprechen zurück, das mit einem Boolean-Wert erfüllt wird, der angibt, ob der Browser ein Einlösungsdatensatz von einem bestimmten Anbieter gespeichert hat.
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.moveBefore(): Verschiebt einen gegebenen Node innerhalb des Document DOM-Knotens als direktes Kind vor einen angegebenen Referenzknoten, ohne den Knoten zu entfernen und dann wieder einzusetzen.
Document.mozSetImageElement(): 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 Zeichenketten 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(): Gibt die aktuelle Maus-Erfassung frei, wenn sie sich auf einem Element in diesem Dokument befindet.
Document.releaseEvents(): Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die vorhandenen Kinder eines Dokuments durch eine angegebene neue Menge von Kindern.
Document.requestStorageAccess(): Ermöglicht einem in drittem Kontext geladenen Dokument (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 Seiten blockieren, die in einem dritten Kontext geladen werden, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor(): Ermöglicht es obersten Websites, den Drittanbieter-Cookie-Zugriff im Namen eingebetteter Inhalte anzufordern, die aus einer anderen Website im selben verwandte Website-Set stammen.
Document.startViewTransition(): Startet eine neue View Transition und gibt ein ViewTransition Objekt zurück, das sie repräsentiert.

Das Document Interface wird mit dem XPathEvaluator Interface erweitert:

Document.createExpression(): Übersetzt einen XPathExpression, der dann für (wiederholte) Auswertungen verwendet werden kann.
Document.createNSResolver(): 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(): Diese Methode macht nichts.
Document.close(): Schließt einen Dokumentenstrom zum Schreiben.
Document.execCommand(): Führt einen Formatierungsbefehl auf einem bearbeitbaren Dokument 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 im angegebenen Dokument liegt.
Document.open(): Öffnet einen Dokumentenstrom zum Schreiben.
Document.queryCommandEnabled(): Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich ausgeführt werden kann.
Document.queryCommandIndeterm(): Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich in einem unbestimmten Zustand ist.
Document.queryCommandState(): Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich ausgeführt wurde.
Document.queryCommandSupported(): Gibt true zurück, wenn der Formatierungsbefehl im aktuellen Bereich unterstützt wird.
Document.queryCommandValue(): Gibt den aktuellen Wert des aktuellen Bereichs für einen Formatierungsbefehl zurück.
Document.write(): Schreibt Text in ein Dokument.
Document.writeln(): 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 eine XSS-sichere Weise mit Bereinigung.
Document.parseHTMLUnsafe(): Erstellt ein neues Document Objekt aus einem HTML-String ohne Bereinigung durchzuführen. Der String darf deklarative Shadow Roots enthalten.

Ereignisse

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignislistener auf die oneventname Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgelisteten Ereignissen können viele Ereignisse von Knoten im Dokumentbaum blubbern.

afterscriptexecute: Wird ausgelöst, wenn ein statisches <script> Element die Skriptausführung beendet.
beforescriptexecute: Wird ausgelöst, wenn ein statisches <script> Element mit der Skriptausführung beginnt.
prerenderingchange: Wird auf einem vorgeladenen Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer sieht die Seite).
securitypolicyviolation: Wird ausgelöst, wenn eine Inhalts-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wird oder verborgen ist.

Vollbild-Ereignisse

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

Lade- und Entladeereignisse

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

Zeigersperren-Ereignisse

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

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn das Dokument oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Dokument oder ein Element das Scrollen abgeschlossen hat.
scrollsnapchange: Wird am Scrollcontainer am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging: Wird am Scrollcontainer ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahlereignisse

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

Geblubberte Ereignisse

Nicht alle Ereignisse, die blubbern, können das Document Objekt erreichen. Nur die folgenden tun es und können am Document Objekt abgehört werden:

Spezifikationen

Spezifikation
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

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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