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 Webseite, die im Browser geladen wird, und dient als Einstiegspunkt für den Inhalt der Webseite, der den DOM-Baum darstellt.

Der DOM-Baum umfasst Elemente wie <body> und <table>, neben vielen anderen. Es bietet globale Funktionalität für das Dokument, wie z.B. das Abrufen 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 Dokumenttyp (z. B. HTML, XML, SVG, …) steht eine größere API zur Verfügung: HTML-Dokumente, die mit dem "text/html" Content-Typ 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 Node und EventTarget Interfaces.

Document.activeElement Schreibgeschützt: Gibt das Element zurück, das derzeit den Fokus hat.
Document.adoptedStyleSheets: Fügt dem Dokument ein Array von konstruierten Stylesheets hinzu. 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 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 ein direkter Nachfolger 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 String 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 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 booleschen Wert zurück, der angibt, ob die Seite als versteckt betrachtet 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 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 angezeigt 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 Mausklicks gesetzt ist, während der Pointer gesperrt ist. null wenn Sperre aussteht, Pointer entsperrt ist oder das Ziel in einem anderen Dokument liegt.
Document.prerendering Schreibgeschützt Experimentell Nicht standardisiert: Gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prozess des Prerenderings ist, wie über 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 der CSSStyleSheet Objekte für Stylesheets zurück, die explizit in ein Dokument eingebunden oder darin 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 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 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

Ruft die Fähigkeit ab/setzt sie, das gesamte Dokument zu bearbeiten.

Document.dir

Ruft die Richtungsentscheidung (rtl/ltr) des Dokuments ab/setzt sie.

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 String zurück.

Named properties

Einige Elemente im Dokument werden auch als Eigenschaften exponiert:

Für jedes <embed>, <form>, <iframe>, <img>, und <object> Element wird sein name (falls nicht leer) exponiert. Zum Beispiel, falls 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 seine id (falls nicht leer) exponiert.
Für jedes <img> Element mit nicht leerem name wird seine id (falls 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 sein contentWindow zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine HTMLCollection mit allen von ihnen zurückgegeben.

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe der aktiven Links im Dokumentkörpe zurück oder setzt sie.
Document.all Veraltet: Bietet Zugriff auf alle Elemente im Dokument — es wird eine HTMLAllCollection zurückgegeben, die an der Wurzel beim Dokumentknoten verankert 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ückgegeben hat.
Document.bgColor Veraltet: Ruft die Hintergrundfarbe des aktuellen Dokuments ab/setzt sie.
Document.charset Veraltet Schreibgeschützt: Alias für Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain Veraltet: Ruft die Domäne des aktuellen Dokuments ab/setzt sie.
Document.fgColor Veraltet: Ruft die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments ab/setzt sie.
Document.fullscreen Veraltet: Gibt true zurück, wenn sich das Dokument im Vollbildmodus befindet.
Document.inputEncoding Veraltet Schreibgeschützt: Alias für 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 geändert wird, indem der Wert von selectedStyleSheetSet gesetzt wird.
Document.linkColor Veraltet: Ruft die Farbe der Hyperlinks im Dokument ab/setzt sie.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt das bevorzugte Stylesheet-Set zurück, wie vom Seitenautor angegeben.
Document.rootElement Veraltet: Ähnlich wie Document.documentElement, jedoch nur für <svg> Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet Veraltet Nicht standardisiert: Gibt an, 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/setzt sie.
Document.xmlEncoding Veraltet: Gibt das Encoding zurück, das durch die XML-Deklaration bestimmt wurde.
Document.xmlStandalone Veraltet: Gibt true zurück, wenn die XML-Deklaration das Dokument als eigenständig (eigenständig ohne externe Einflüsse auf den Inhalt, zum Beispiel durch externe Teile der DTD) auflistet, sonst false.
Document.xmlVersion Veraltet: Gibt die Versionsnummer zurück, wie in der XML-Deklaration angegeben, oder "1.0", wenn die Deklaration fehlt.

Instanz-Methoden

Dieses Interface erbt auch von den Node und EventTarget Interfaces.

Document.adoptNode(): Adoptiert einen Knoten aus einem externen Dokument.
Document.append(): Fügt eine Reihe von Node Objekten oder Strings 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 repräsentieren, eines aus jeder der letzten drei Epochen. Standardmäßig lässt die Methode den Browser auch den aktuellen Seitenbesuch aufzeichnen, wie vom Anrufer beobachtet, damit 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 Zeichenversatz 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 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 gegebenen Tag-Namen und Namensraum-URI.
Document.createEvent() Veraltet: Erstellt ein Event-Objekt.
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 aktuellen Dokument-Elements.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock(): Hebt die Zeigersperre auf.
Document.getAnimations(): Gibt ein Array aller Animation Objekte zurück, die derzeit aktiv sind und deren Zielelemente Nachkommen des Dokuments sind.
Document.getBoxQuads() Experimentell: Gibt eine Liste von DOMQuad Objekten zurück, die die CSS-Fragmente des Knotens darstellen.
Document.getElementById(): Gibt eine Objektreferenz 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 Namensraum zurück.
Document.getSelection(): Gibt ein Selection Objekt zurück, das den von Benutzer ausgewählten Textbereich oder die aktuelle Position der Einfügemarke repräsentiert.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem Booleschen 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() Experimentell: Verschiebt einen angegebenen Node ins Document DOM, bevor einen angegebenen Referenzknoten, ohne den Knoten zu entfernen und dann einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht Ihnen, das Element zu ändern, das als Hintergrundbild für eine angegebene Element-ID verwendet wird.
Document.prepend(): Fügt eine Reihe von Node Objekten oder Strings vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt den ersten Elementknoten im Dokument in Dokument-Reihenfolge zurück, der den angegebenen Selektoren entspricht.
Document.querySelectorAll(): Gibt eine Liste aller Elementknoten im Dokument zurück, die den angegebenen Selektoren entsprechen.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Maus-Erfassung frei, wenn sie auf einem Element in diesem Dokument ist.
Document.releaseEvents() Veraltet: Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die bestehenden Kinder eines Dokuments durch ein angegebenes neues Set von Kindern.
Document.requestStorageAccess(): Ermöglicht einem in einem Drittanbieter-Kontext geladenen Dokument (z. B. eingebettet in ein <iframe>) den Zugriff auf unpartitionierte Cookies zu beantragen. Dies wird in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies durch Webseiten, die in einem Drittanbieter-Kontext geladen werden, blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Ermöglicht es Webseiten auf oberster Ebene, Drittanbieter-Cookie-Zugriff im Namen von eingebetteten Inhalten zu beantragen, die von einer anderen Seite am selben related website set stammen.
Document.startViewTransition(): Startet eine neue Ansichtsübergang und gibt ein ViewTransition Objekt zurück, um es 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(): 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 tut nichts.
Document.close(): Schließt einen Dokumentstream für das Schreiben.
Document.execCommand() Veraltet: 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 innerhalb des angegebenen Dokuments liegt.
Document.open(): Öffnet einen Dokumentstream für das Schreiben.
Document.queryCommandEnabled() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich ausgeführt werden kann.
Document.queryCommandIndeterm() Veraltet: Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich in einem unbestimmten Zustand ist.
Document.queryCommandState() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich ausgeführt wurde.
Document.queryCommandSupported() Veraltet Nicht standardisiert: Gibt true zurück, wenn der Formatierungsbefehl auf dem 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 Zeile Text in ein Dokument.

Statische Methoden

Dieses Interface erbt auch von den Node und EventTarget Interfaces.

Document.parseHTML(): Erstellt ein neues Document Objekt aus einem HTML-String auf XSS-sichere Weise mit Sanitisierung.
Document.parseHTMLUnsafe(): Erstellt ein neues Document Objekt aus einem HTML-String ohne Sanitisierung. Der String kann deklarative Shadow-Roots enthalten.

Ereignisse

Diese Ereignisse können mit addEventListener() oder durch Zuweisen eines Ereignislistener zur oneventname Eigenschaft dieser Schnittstelle überwacht werden. Zusätzlich zu den unten aufgelisteten Ereignissen, können viele Ereignisse von Knoten aus dem Dokumentbaum hochblubbern.

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> gleich mit der Skriptausführung beginnt.
prerenderingchange Experimentell: Wird auf einem prerenderten Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite anzeigt).
securitypolicyviolation: Wird ausgelöst, wenn eine Content Security Policy verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar oder versteckt wird.

Vollbild-Ereignisse

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

Lade- und Entlade-Ereignisse

DOMContentLoaded: Wird ausgelöst, wenn das Dokument vollständig geladen und geparst wurde, ohne auf das Laden von Stylesheets, Bildern und Unterrahmen zu warten.
readystatechange: Wird ausgelöst, wenn das readyState Attribut eines Dokuments sich geändert hat.

Zeiger-Sperre-Ereignisse

pointerlockchange: Wird ausgelöst, wenn der Zeiger gesperrt/freigegeben wird.
pointerlockerror: Wird ausgelöst, wenn das Sperren des Zeigers fehlschlägt.

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn das Dokument-View oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Scrollen eines Dokument-Views oder eines Elements abgeschlossen ist.
scrollsnapchange Experimentell: Wird am Scroll-Container am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Ziel für den Scroll-Schnappschuss ausgewählt wurde.
scrollsnapchanging Experimentell: Wird am Scroll-Container ausgelöst, wenn der Browser ermittelt, dass ein neuer Zielpunkt für den Scroll-Schnappschuss wartet, d.h. er 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.

Bubbling-Ereignisse

Nicht alle Ereignisse, die hochblubbern, erreichen das Document-Objekt. Nur die folgenden tun dies und können auf dem Document-Objekt überwacht 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