Document

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 eine in den Browser geladene Webseite 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. Es bietet funktionale Möglichkeiten auf Dokumentebene, wie zum Beispiel, um die URL der Seite zu erhalten und neue Elemente im Dokument zu erstellen.

Das Document-Interface beschreibt die gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Typ des Dokuments (z.B. HTML, XML, SVG, …), steht eine größere API zur Verfügung: HTML-Dokumente, die mit dem Content-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 derzeit den Fokus hat.
Document.activeViewTransition Schreibgeschützt: Gibt eine ViewTransition-Instanz zurück, die die derzeit im Dokument aktive Ansichtsübergang darstellt, oder null, wenn kein aktiver Ansichtsübergang besteht.
Document.adoptedStyleSheets: Fügt ein Array von erstellten Stylesheets hinzu, die vom Dokument verwendet werden sollen. 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 Zeichen-Set zurück, das vom Dokument verwendet wird.
Document.childElementCount Schreibgeschützt: Gibt die Anzahl der Kind-Elemente des aktuellen Dokuments zurück.
Document.children Schreibgeschützt: Gibt die Kind-Elemente 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 vom 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.customElementRegistry Schreibgeschützt: Das CustomElementRegistry-Objekt, das mit diesem Dokument assoziiert ist, oder null, wenn keines festgelegt wurde.
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. Für HTML-Dokumente ist dies normalerweise das HTMLHtmlElement-Objekt, das das Dokument<html>-Element 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 Schreibgeschützt: Gibt die FeaturePolicy-Schnittstelle mit den auf das Dokument angewandten Feature-Richtlinien zurück.
Document.firstElementChild Schreibgeschützt: Gibt das erste Kind-Element des aktuellen Dokuments zurück.
Document.fonts: Gibt die FontFaceSet-Schnittstelle 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 aktuell 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 ausgeblendet 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 mit dem aktuellen Dokument verbunden ist.
Document.lastElementChild Schreibgeschützt: Gibt das letzte Kind-Element 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 gerade 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 in einem anderen Dokument liegt.
Document.prerendering Schreibgeschützt: Gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prozess des Vorbereitens ist, 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 die Zeitleiste als spezielle Instanz von DocumentTimeline zurück, die beim Laden der Seite automatisch erstellt wird.
Document.visibilityState Schreibgeschützt: Gibt eine string zurück, die den Sichtbarkeitsstatus des Dokuments bezeichnet. 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 mit 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

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

Document.dir

Holt/legt die Richtung (rtl/ltr) des Dokuments fest.

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 Speicherort des Dokuments als Zeichenfolge zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften bereitgestellt:

Für jedes <embed>, <form>, <iframe>, <img>, und <object>-Element wird sein name (falls nicht leer) bereitgestellt. 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) bereitgestellt.
Für jedes <img>-Element mit nicht leerem name wird sein id (falls nicht leer) bereitgestellt.

Wenn eine Eigenschaft einem einzigen 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 zurückgegeben, die alle enthält.

Veraltete Eigenschaften

Document.alinkColor: Gibt die Farbe aktiver Links im Dokumentinhalt zurück oder setzt diese.
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. Veraltete Eigenschaft, die früher die Liste der Applets in einem Dokument zurückgab.
Document.bgColor: Holt/legt die Hintergrundfarbe des aktuellen Dokuments fest.
Document.charset Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain: Holt/legt die Domain des aktuellen Dokuments fest.
Document.fgColor: Holt/legt die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments fest.
Document.fullscreen: Gibt true zurück, wenn das Dokument im Vollbildmodus ist.
Document.inputEncoding Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Schreibgeschützt: Gibt den Namen des Style-Sheet-Sets zurück, das zuletzt aktiviert wurde. Hat den Wert null, bis das Style-Sheet durch Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor: Holt/legt die Farbe von Hyperlinks im Dokument fest.
Document.preferredStyleSheetSet Schreibgeschützt: Gibt das bevorzugte Style-Sheet-Set zurück, wie vom Seitenautor festgelegt.
Document.rootElement: Wie Document.documentElement, aber nur für <svg> Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet: Gibt zurück, welches Style-Sheet-Set derzeit verwendet wird.
Document.styleSheetSets Schreibgeschützt: Gibt eine Liste der Style-Sheet-Sets zurück, die im Dokument verfügbar sind.
Document.vlinkColor: Holt/legt die Farbe von besuchten Hyperlinks fest.
Document.xmlEncoding: Gibt die Kodierung zurück, wie sie in der XML-Deklaration angegeben ist.
Document.xmlStandalone: Gibt true zurück, wenn die XML-Deklaration das Dokument als eigenständig angibt (z.B., ein externer Teil der DTD beeinflusst den Inhalt des Dokuments), ansonsten false.
Document.xmlVersion: 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 von einem externen Dokument.
Document.append(): Fügt eine Reihe von Node-Objekten oder Zeichenfolgen nach dem letzten Kind des Dokuments ein.
Document.ariaNotify(): Gibt an, dass eine bestimmte Textzeichenfolge von einem Bildschirmleser angekündigt werden soll.
Document.browsingTopics(): 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 führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als Beobachtung durch den Anrufer aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung verwendet werden kann. Weitere Informationen finden Sie in der Topics API.
Document.captureEvents(): Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition-Objekt zurück, das den DOM-Knoten und die Zeichenposition des Cursors innerhalb dieses Knotens enthält.
Document.caretRangeFromPoint(): Holt 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 ein neues Attributknoten in einem bestimmten Namensraum und gibt es zurück.
Document.createCDATASection(): Erstellt ein neues CDATA-Knoten und gibt es zurück.
Document.createComment(): Erstellt ein neues Kommentarknoten und gibt es 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(): 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 ein Textknoten.
Document.createTouch(): Erstellt ein Touch-Objekt.
Document.createTouchList(): Erstellt eine 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 Style-Sheet-Set.
Document.exitFullscreen(): Stoppt die Darstellung des Dokuments im Vollbildmodus.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-im-Bild-Fenster und gibt es an seinen ursprünglichen Container zurück.
Document.exitPointerLock(): Hebt die Zeigersperre auf.
Document.getAnimations(): Gibt ein Array aller Animation-Objekte zurück, die derzeit in Kraft sind, deren Ziel-Elemente Nachkommen des document sind.
Document.getBoxQuads(): 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 Klassenname 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 Bereich des vom Benutzer ausgewählten Textes oder die aktuelle Position des Cursors darstellt.
Document.hasPrivateToken(): Gibt ein Versprechen zurück, das mit einem boolean erfüllt wird, der angibt, ob der Browser ein Privater Zustands-Token vom bestimmten Aussteller gespeichert hat.
Document.hasRedemptionRecord(): Gibt ein Versprechen zurück, das mit einem boolean erfüllt wird, der angibt, ob der Browser einen Erlösungsdatensatz vom bestimmten Aussteller hat.
Document.hasStorageAccess(): Gibt ein Promise zurück, das sich mit einem booleschen Wert erfüllt, 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 gegebenen Referenzknoten, ohne den Knoten zu entfernen und dann 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 Reihe von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt den ersten Elementknoten innerhalb des Dokuments in Dokumentreihenfolge zurück, der den angegebenen Selektoren entspricht.
Document.querySelectorAll(): Gibt eine Liste aller Elementknoten innerhalb des Dokuments zurück, die den angegebenen Selektoren entsprechen.
Document.releaseCapture(): Gibt die aktuelle Mausaufnahme frei, wenn sie sich auf einem Element in diesem Dokument befindet.
Document.releaseEvents(): Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die bestehenden Kinder eines Dokuments durch einen angegebenen neuen Satz von Kindern.
Document.requestStorageAccess(): Ermöglicht einem in einem Drittkontext geladenen Dokument (d.h. eingebettet in ein <iframe>), Zugriff auf unpartitionierte Cookies zu beantragen, für Fälle, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies durch in einem Dritt-Kontext geladene Sites blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor(): Ermöglicht es Top-Level-Sites, Drittanbieter-Cookie-Zugriff im Auftrag von eingebetteten Inhalten anzufordern, die von einer anderen Site im selben verwandten Website-Set stammen.
Document.startViewTransition(): Startet einen neuen Ansichtsübergang und gibt ein ViewTransition-Objekt zurück, um ihn darzustellen.

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(): Gibt den Eingabeknoten wie er ist 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(): Diese Methode macht nichts.
Document.close(): Schließt einen Dokumentstream für das Schreiben.
Document.execCommand(): Führt einen Formatierungsbefehl auf einem editierbaren 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(): Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich ausgeführt werden kann.
Document.queryCommandIndeterm(): Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich in einem unbestimmten Zustand ist.
Document.queryCommandState(): Gibt true zurück, wenn der Formatierungsbefehl auf dem aktuellen Bereich ausgeführt wurde.
Document.queryCommandSupported(): Gibt true zurück, wenn der Formatierungsbefehl auf dem 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 einer HTML-Zeichenfolge in einer XSS-sicheren Weise mit Desinfektion.
Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenfolge, ohne eine Desinfektion durchzuführen. Die Zeichenfolge kann deklarative Shadow-Wurzeln enthalten.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten stammen, die im Dokumentbaum enthalten sind.

afterscriptexecute: Wird ausgelöst, wenn ein statisches <script>-Element das Ausführen seines Skripts beendet hat.
beforescriptexecute: Wird ausgelöst, wenn ein statisches <script>-Element mit der Ausführung beginnt.
prerenderingchange: Wird bei einem vorbereiteten Dokument ausgelöst, wenn es aktiviert (d.h. vom Benutzer angesichtigt wird) wird.
securitypolicyviolation: Wird ausgelöst, wenn eine Inhaltsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar geworden ist oder ausgeblendet wurde.

Vollbild-Ereignisse

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

Lade- und Entlade-Ereignisse

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

Zeigersperr-Ereignisse

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

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn das Dokumentfenster oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Dokumentfenster oder ein Element das Scrolling 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 feststellt, dass ein neues Scroll-Snap-Ziel aussteht, 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.

Geänderte Ereignisse

Nicht alle Änderungen an Ereignissen können das Document-Objekt erreichen. Nur die folgenden und können auf dem Document-Objekt gehö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