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.

Das Document-Interface repräsentiert jede im Browser geladene Webseite und dient als Einstiegspunkt in den Inhalt der Webseite, der der DOM-Baum ist.

Der DOM-Baum enthält Elemente wie <body> und <table>, neben vielen anderen. Er bietet Funktionen global für das Dokument an, wie zum Beispiel, 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 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" serviert 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 den aktuell aktiven View-Übergang im Dokument darstellt, oder null, wenn kein aktiver View-Übergang vorhanden ist.
Document.adoptedStyleSheets: Fügt ein Array von erstellten Stylesheets hinzu, die vom Dokument verwendet werden sollen. Diese Stylesheets können auch mit Schatten-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 den Zeichensatz zurück, der 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.customElementRegistry Schreibgeschützt: Gibt das CustomElementRegistry-Objekt zurück, das mit diesem Dokument assoziiert ist, oder null, wenn keines gesetzt 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. Bei HTML-Dokumenten ist dies normalerweise das HTMLHtmlElement-Objekt, das das <html>-Element des Dokuments darstellt.
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 booleschen Wert zurück, der anzeigt, 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 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 im Bild-in-Bild-Modus in diesem Dokument dargestellt 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 Sperrung ausstehend ist, der Zeiger entsperrt ist oder wenn das Ziel in einem anderen Dokument liegt.
Document.prerendering Schreibgeschützt: Gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prerendering-Prozess 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 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 eine string-Kennzeichnung des Sichtbarkeitszustands des Dokuments zurück. 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

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

Document.dir

Ruft die Richtung (rtl/ltr) des Dokuments ab/legt sie 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 ruft den Titel des aktuellen Dokuments ab.

Document.URL Schreibgeschützt

Gibt den Speicherort des Dokuments als Zeichenkette zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften exposed:

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

Wenn eine Eigenschaft einem einzigen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn es sich bei diesem einzigen Element um ein Iframe handelt, 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 von aktiven Links im Dokumentenkörper zurück oder setzt diese.
Document.all: Bietet Zugriff auf alle Elemente im Dokument — es gibt eine HTMLAllCollection zurück, die am Dokumentenknoten verwurzelt ist. Dies ist eine alte, nicht standardkonforme 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 alte Eigenschaft, die früher die Liste der Applets innerhalb eines Dokuments zurückgab.
Document.bgColor: Ruft die Hintergrundfarbe des aktuellen Dokuments ab/setzt sie.
Document.charset Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain: Ruft die Domain des aktuellen Dokuments ab/setzt sie.
Document.fgColor: Ruft die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments ab/setzt sie.
Document.fullscreen: Gibt true zurück, wenn sich das Dokument im Vollbildmodus befindet.
Document.inputEncoding Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.lastStyleSheetSet Schreibgeschützt: Gibt den Namen des zuletzt aktivierten Stylesheet-Sets zurück. Hat den Wert null, bis das Stylesheet durch das Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor: Ruft die Farbe der Hyperlinks im Dokument ab/setzt sie.
Document.preferredStyleSheetSet Schreibgeschützt: Gibt das bevorzugte Stylesheet-Set zurück, wie vom Seitenautor angegeben.
Document.rootElement: Wie Document.documentElement, jedoch 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 im Dokument verfügbaren Stylesheet-Sets zurück.
Document.vlinkColor: Ruft die Farbe der besuchten Hyperlinks ab/setzt sie.
Document.xmlEncoding: Gibt die Kodierung zurück, wie sie in der XML-Deklaration festgelegt ist.
Document.xmlStandalone: Gibt true zurück, wenn die XML-Deklaration das Dokument als selbststehend angibt (z. B. wenn ein externer Teil der DTD den Inhalt des Dokuments beeinflusst), andernfalls 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(): Adoptiert 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.ariaNotify(): Gibt an, dass ein bestimmter Text von einem Bildschirmlesegerät angesagt werden soll.
Document.browsingTopics(): Gibt ein Versprechen zurück, das mit einem Array von Objekten erfüllt wird, die die Hauptthemen des Benutzers darstellen, eines aus jedem der letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, damit der Hostname der Seite später in der Themenberechnung verwendet werden kann. Siehe die Topics API für weitere Details.
Document.captureEvents(): Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition-Objekt zurück, das den DOM-Knoten enthält, der den Cursor enthält, und den Zeichenversatz des Cursors innerhalb dieses Knotens.
Document.caretRangeFromPoint(): 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 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 Darstellung des Elementes im Vollbildmodus des Dokuments.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock(): Gibt die Zeigersperrung frei.
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 darstellen.
Document.getElementById(): Gibt eine Objektreferenz 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 Namespace 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 booleschen Wert erfüllt wird, der anzeigt, ob der Browser ein privates Zustands-Token von einem bestimmten Aussteller gespeichert hat.
Document.hasRedemptionRecord(): Gibt ein Versprechen zurück, das mit einem booleschen Wert erfüllt wird, der anzeigt, ob der Browser ein Einlösungsprotokoll von einem bestimmten Aussteller hat.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem booleschen Wert erfüllt wird, der anzeigt, 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 bestimmten Node innerhalb des Document-DOM-Knotens als direktes Kind vor einen bestimmten Referenzknoten, ohne den Knoten zu entfernen und dann wieder einzufügen.
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 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 im Dokument 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 vorhandenen Kinder eines Dokuments durch einen bestimmten neuen Satz von Kindern.
Document.requestStorageAccess(): Ermöglicht einem in einem Drittanbieter-Kontext (d.h. eingebettet in ein <iframe>) geladenem Dokument, den Zugriff auf unpartitionierte Cookies anzufordern, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies von in einem Drittanbieter-Kontext geladenen Sites blockieren, um den Datenschutz zu verbessern.
Document.requestStorageAccessFor(): Ermöglicht obersten Sites, Drittanbieter-Cookie-Zugriff im Namen eingebetteter Inhalte von einer anderen Site im selben verwandten Website-Set anzufordern.
Document.startViewTransition(): Startet einen neuen View-Ü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 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 Dokumentstrom zum Schreiben.
Document.execCommand(): Führt einen Formatierungsbefehl in einem editierbaren Dokument aus.
Document.getElementsByName(): Gibt eine Liste von Elementen mit dem angegebenen Namen zurück.
Document.hasFocus(): Gibt true zurück, wenn sich der Fokus derzeit irgendwo innerhalb des angegebenen Dokuments befindet.
Document.open(): Öffnet einen Dokumentstrom 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 sich der Formatierungsbefehl im aktuellen Bereich in einem unbestimmten Zustand befindet.
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 einer HTML-Zeichenfolge auf XSS-sichere Weise mit Sanitärbereich.
Document.parseHTMLUnsafe(): Erstellt ein neues Document-Objekt aus einer HTML-Zeichenfolge ohne Durchführung einer Reinigung. Die Zeichenfolge kann deklarative Schattenwurzeln enthalten.

Ereignisse

Diese Ereignisse können mit addEventListener() oder durch Zuweisen eines Ereignislisteners zur oneventname-Eigenschaft dieses Interfaces gehört werden. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten, die im Dokumentbaum enthalten sind, hochblubbern.

afterscriptexecute: Wird ausgelöst, wenn ein statisches <script>-Element die Ausführung seines Skripts beendet
beforescriptexecute: Wird ausgelöst, wenn ein statisches <script> die Ausführung beginnt.
prerenderingchange: Wird bei einem prerendered Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite sieht).
securitypolicyviolation: Wird ausgelöst, wenn eine Content-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar geworden oder versteckt wurde.

Vollbild-Ereignisse

fullscreenchange: Wird ausgelöst, wenn das Dokument in den Vollbildmodus wechselt oder diesen verlässt.
fullscreenerror: Wird ausgelöst, wenn beim Versuch, in den oder aus dem Vollbildmodus zu wechseln, ein Fehler 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 Unterframes das Laden abschließen.
readystatechange: Wird ausgelöst, wenn sich das readyState-Attribut eines Dokuments geändert hat.

Zeigersperrungs-Ereignisse

pointerlockchange: Wird ausgelöst, wenn der Zeiger gesperrt/entsperrt wird.
pointerlockerror: Wird ausgelöst, wenn die Zeigersperrung fehlgeschlagen ist.

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn die Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn das Scrollen der Dokumentansicht oder eines Elements abgeschlossen ist.
scrollsnapchange: Wird am Scroll-Container am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging: Wird am Scroll-Container 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 auf einem Dokument geändert wird.

Geblubberte Ereignisse

Nicht alle geblubberten Ereignisse können das Document-Objekt erreichen. Nur die folgenden können 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