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 im Browser geladene Webseite und dient als Einstiegspunkt in den Inhalt der Webseite, was der DOM-Baum ist.

Der DOM-Baum umfasst Elemente wie <body> und <table>, unter vielen anderen. Er bietet globale Funktionalität 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 gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Typ des Dokuments (z.B. HTML, XML, SVG, …) steht eine umfangreichere 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.

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 aus konstruierten Stylesheets hinzu. Diese Stylesheets können auch mit Schatten-DOM-Subbä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 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 Dokumenttypdefinition (DTD) des aktuellen Dokuments zurück.
Document.documentElement Schreibgeschützt: Gibt das Element zurück, das ein direkter Nachkomme des Dokuments ist. Für HTML-Dokumente ist dies normalerweise das HTMLHtmlElement Objekt, das das <html> des Dokuments repräsentiert.
Document.documentURI Schreibgeschützt: Gibt den Standort 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-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 das 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 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 assoziiert 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 dargestellt 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 ist, während der Zeiger gesperrt ist. null wenn die Sperre aussteht, der Zeiger entsperrt ist oder wenn das Ziel in einem anderen Dokument ist.
Document.prerendering Schreibgeschützt Experimentell Nicht standardisiert: Gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument derzeit im Prozess des Prerendings 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 einem Dokument verlinkt 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 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 hierfür 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

Gibt die Fähigkeit an, das gesamte Dokument zu bearbeiten, bzw. setzt diese.

Document.dir

Holt/setzt die Richtung (rtl/ltr) des Dokuments.

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 holt den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt den Standort des Dokuments als String zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften exponiert:

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

Wenn eine Eigenschaft einem einzigen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn dieses Einzelelement 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 Dokument zurück oder setzt diese.
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: Holt/setzt die Hintergrundfarbe des aktuellen Dokuments.
Document.charset Veraltet Schreibgeschützt: Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.
Document.domain Veraltet: Holt/setzt die Domain des aktuellen Dokuments.
Document.fgColor Veraltet: Holt/setzt die Vordergrundfarbe oder Textfarbe des aktuellen Dokuments.
Document.fullscreen Veraltet: Gibt true zurück, wenn das Dokument im Vollbildmodus ist.
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 Stylesheet-Sets zurück. Hat den Wert null, bis das Stylesheet durch Setzen des Wertes von selectedStyleSheetSet geändert wird.
Document.linkColor Veraltet: Holt/setzt die Farbe der Hyperlinks im Dokument.
Document.preferredStyleSheetSet Veraltet Schreibgeschützt Nicht standardisiert: Gibt das bevorzugte Stylesheet-Set zurück, wie es vom Seitenautor angegeben wurde.
Document.rootElement Veraltet: Wie Document.documentElement, aber nur für <svg> Wurzelelemente. Verwenden Sie stattdessen diese Eigenschaft.
Document.selectedStyleSheetSet Veraltet Nicht standardisiert: Gibt zurück, welches Stylesheet-Set momentan 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: Holt/setzt die Farbe der besuchten Hyperlinks.
Document.xmlEncoding Veraltet: Gibt die Kodierung gemäß der XML-Deklaration zurück.
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 Inhalt des Dokuments), sonst false.
Document.xmlVersion Veraltet: 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 Node und EventTarget Interfaces.

Document.adoptNode(): Knoten aus einem externen Dokument übernehmen.
Document.append(): Fügt eine Reihe von Node Objekten oder Zeichenfolgen nach dem letzten Kind des Dokuments ein.
Document.browsingTopics() Experimentell Nicht standardisiert: Gibt ein Promise zurück, das sich mit einem Array von Objekten erfüllt, die die Top-Themen des Benutzers darstellen, eines aus jeder der letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch wie vom Anrufer beobachtet aufzeichnet, damit der Hostname der Seite später in der Themenberechnung verwendet werden kann. Siehe Topics API für mehr Details.
Document.captureEvents() Veraltet: Siehe Window.captureEvents.
Document.caretPositionFromPoint(): Gibt ein CaretPosition Objekt zurück, das den DOM-Knoten, der das Caret enthält, und den Zeichenoffset des Carets innerhalb dieses Knotens enthält.
Document.caretRangeFromPoint() Nicht standardisiert: Gibt ein Range Objekt für das Dokumentfragment unter den angegebenen Koordinaten zurück.
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 Namespace-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(): Hält das Darstellen des Vollbildelements des Dokuments im Vollbildmodus an.
Document.exitPictureInPicture(): Entfernt das Video vom schwebenden Bild-im-Bild-Fenster zurück zu seinem ursprünglichen Container.
Document.exitPointerLock(): Hebt die Einstellung der Zeigersperre auf.
Document.getAnimations(): Gibt ein Array aller Animation Objekte zurück, die derzeit in Kraft sind, deren Zielelemente Nachkommen des Documents sind.
Document.getBoxQuads() Experimentell: 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 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.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 einen Klon 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 einzufügen.
Document.mozSetImageElement() Nicht standardisiert: Ermöglicht es 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 Zeichenfolgen vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt das erste Element-Knoten innerhalb des Dokuments in Dokumentreihenfolge zurück, das den angegebenen Selektoren entspricht.
Document.querySelectorAll(): Gibt eine Liste aller Element-Knoten innerhalb des Dokuments zurück, die den angegebenen Selektoren entsprechen.
Document.releaseCapture() Nicht standardisiert: Gibt die aktuelle Maus-Erfassung frei, 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 einen angegebenen neuen Satz von Kindern.
Document.requestStorageAccess(): Ermöglicht es einem Dokument, das in einem Drittkontext geladen wurde (d.h. eingebettet in ein <iframe>), den Zugriff auf unpartitionierte Cookies zu beantragen, in Fällen, in denen Benutzeragenten standardmäßig den Zugriff auf unpartitionierte Cookies für in einem Drittkontext geladene Sites blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Ermöglicht es obersten Sites, Drittanbieter-Cookie-Zugriff im Namen von eingebettetem Inhalt, der von einer anderen Site im gleichen verwandten Webseiten-Set stammt, zu beantragen.
Document.startViewTransition(): Startet einen neuen Ansichtstransition 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) Bewertungen 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 hierfür erweitert:

Document.clear() Veraltet: Diese Methode tut nichts.
Document.close(): Schließt einen Dokumentstream zum Schreiben.
Document.execCommand() Veraltet: Führt in einem bearbeitbaren Dokument einen Formatierungsbefehl 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 Dokumentstream zum 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() 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 einer HTML-Zeichenfolge auf eine XSS-sichere Weise mit Sanitärverfahren.
Document.parseHTMLUnsafe(): Erstellt ein neues Document Objekt aus einer HTML-Zeichenfolge, ohne eine Sicherheitsprüfung durchzuführen. Die Zeichenfolge kann deklarative Schattenwurzeln enthalten.

Ereignisse

Hören Sie auf diese Ereignisse durch die Verwendung von addEventListener() oder indem Sie einen Ereignis-Listener der oneventname Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten im Dokumentbaum auftauchen.

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> Element das Skript ausgeführt hat
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> kurz davor ist, das Skript auszuführen.
prerenderingchange Experimentell: Wird auf einem prerenderten Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite ansieht).
securitypolicyviolation: Wird ausgelöst, wenn eine Inhalts-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar wird oder verborgen wurde.

Vollbild-Ereignisse

fullscreenchange: Wird ausgelöst, wenn das Document in den Vollbildmodus wechselt oder diesen verlässt.
fullscreenerror: Wird ausgelöst, wenn ein Fehler beim Versuch in den Vollbildmodus zu wechseln oder diesen zu verlassen, auftritt.

Lade- und Entladeereignisse

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

Zeigersperr-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 Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn die Dokumentansicht oder ein Element das Scrollen abgeschlossen hat.
scrollsnapchange Experimentell: Wird am Scrollcontainer nach Abschluss eines Scrollvorgangs ausgelöst, wenn ein neues Scrollsnappziel ausgewählt wurde.
scrollsnapchanging Experimentell: Wird am Scrollcontainer ausgelöst, wenn der Browser ein neues Scrollsnappziel ermittelt, das ansteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahl-Ereignisse

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

Geplusterte Ereignisse

Nicht alle Ereignisse, die sprudeln, können das Document Objekt erreichen. Nur die folgenden und können am Document Objekt angehö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

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