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, also den DOM-Baum.

Der DOM-Baum umfasst Elemente wie <body> und <table>, unter vielen anderen. Es bietet Funktionalität global für das Dokument, 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" bereitgestellt werden, implementieren zusätzlich 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 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-Teilbäumen desselben Dokuments geteilt werden.
Document.body: Gibt den <body> oder <frameset> Knoten des aktuellen Dokuments zurück.
Document.characterSet Schreibgeschützt: Gibt das von dem Dokument verwendete Zeichensatz zurück.
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.doctype Schreibgeschützt: Gibt die Dokumententyp-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 Dokumentstandort 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 Boolean-Wert zurück, der angibt, 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 mit dem aktuellen Dokument verbundene 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 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 Sperre aussteht, der Zeiger entsperrt ist oder wenn das Ziel in einem anderen Dokument ist.
Document.prerendering Schreibgeschützt Experimentell: Gibt einen Boolean zurück, der angibt, ob das Dokument derzeit im Prerendering-Prozess 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 zu dem Element zurück, das das Dokument scrollt.
Document.styleSheets Schreibgeschützt: Gibt eine StyleSheetList von CSSStyleSheet Objekten für explizit in ein Dokument eingebettete oder verlinkte Stylesheets zurück.
Document.timeline Schreibgeschützt: Gibt die Zeitachse 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 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 Interface HTMLDocument oder wird für solche Dokumente erweitert.

Document.cookie

Gibt eine durch Semikolons getrennte Liste der Cookies für das Dokument zurück oder setzt ein einzelnes Cookie.

Document.defaultView Schreibgeschützt

Gibt eine Referenz auf das Fensterobjekt zurück.

Document.designMode

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

Document.dir

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

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 Ladestatus des Dokuments zurück.

Document.referrer Schreibgeschützt

Gibt die URI der Seite zurück, die zu dieser Seite verlinkt hat.

Document.title

Setzt oder holt den Titel des aktuellen Dokuments.

Document.URL Schreibgeschützt

Gibt die Dokumentlokation 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 deren name (wenn nicht leer) exponiert. Zum Beispiel, wenn 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 dessen id (sofern nicht leer) exponiert.
Für jedes <img> Element mit nicht-leerem name wird dessen id (sofern 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 dessen contentWindow zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine HTMLCollection zurückgegeben, die alle enthält.

Veraltete Eigenschaften

Document.alinkColor Veraltet: Gibt die Farbe der aktiven Links im Dokumentkörper 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 alte, 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. Eine 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 für 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 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 durch Setzen des Werts 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 derzeit verwendet wird.
Document.styleSheetSets Veraltet Schreibgeschützt Nicht standardisiert: Gibt eine Liste der auf das Dokument verfügbaren Stylesheet-Sets zurück.
Document.vlinkColor Veraltet: Holt/setzt die Farbe besuchter Hyperlinks.
Document.xmlEncoding Veraltet: Gibt die Codierung zurück, wie sie durch die XML-Deklaration bestimmt wurde.
Document.xmlStandalone Veraltet: Gibt true zurück, wenn die XML-Deklaration angibt, dass das Dokument unabhängig ist (z. B., Ein externer Teil der DTD beeinflusst den Inhalt des Dokuments), andernfalls false.
Document.xmlVersion Veraltet: Gibt die Versionsnummer zurück, wie sie in der XML-Deklaration angegeben ist oder "1.0", falls die Deklaration fehlt.

Instanz-Methoden

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.adoptNode(): Übernimmt einen 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() Experimentell Nicht standardisiert: Gibt an, dass eine bestimmte Textzeichenfolge von einem Screenreader angekündigt werden sollte.
Document.browsingTopics() Experimentell Nicht standardisiert: Gibt ein Versprechen zurück, das mit einem Array von Objekten erfüllt wird, die die Top-Themen des Nutzers repräsentieren, eines aus jedem der letzten drei Epochen. Standardmäßig verursacht die Methode auch, dass der Browser den aktuellen Seitenbesuch als von dem Anrufer beobachtet erfasst, sodass der Hostname der Seite später zur Berechnung von Themen 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 enthält, der die Einfügemarke enthält, und den Zeichenenversatz der Einfügemarke innerhalb dieses Knotens.
Document.caretRangeFromPoint() Nicht standardisiert: 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 einen neuen Attributknoten in einem angegebenen 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 gegebenen Tag-Namen.
Document.createElementNS(): Erstellt ein neues Element mit dem gegebenen Tag-Namen und Namespace-URI.
Document.createEvent() Veraltet: 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() 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 die Darstellung des Vollbildelements des Dokuments im Vollbildmodus.
Document.exitPictureInPicture(): Entfernt das Video aus dem schwebenden Bild-in-Bild-Fenster zurück in seinen ursprünglichen Container.
Document.exitPointerLock(): Gibt die Zeigersperre frei.
Document.getAnimations(): Gibt ein Array aller Animation Objekte zurück, die derzeit aktiv sind und deren Ziel-Elemente Nachkommen des document sind.
Document.getBoxQuads() Experimentell: Gibt eine Liste von [DOMQuad](/de/docs/Web/API/DOM

Quad) 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 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 Namespace zurück.
Document.getSelection(): Gibt ein Selection Objekt zurück, das den vom Nutzer ausgewählten Textrange oder die aktuelle Position der Einfügemarke darstellt.
Document.hasStorageAccess(): Gibt ein Promise zurück, das mit einem Boolean-Wert erfüllt wird, der angibt, ob das Dokument Zugang zu nicht partitionierten 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(): Bewegt einen angegebenen Node innerhalb des Document DOM-Knotens als direktes Kind vor einem 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 Zeichenfolgen vor dem ersten Kind des Dokuments ein.
Document.querySelector(): Gibt den ersten Elementknoten im Dokument zurück, in der Dokumentreihenfolge, 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 Mausaufnahme frei, wenn sie auf einem Element in diesem Dokument ist.
Document.releaseEvents() Veraltet: Siehe Window.releaseEvents().
Document.replaceChildren(): Ersetzt die vorhandenen Kinder eines Dokuments durch eine angegebene neue Menge von Kindern.
Document.requestStorageAccess(): Ermöglicht einem in einem Drittanbieter-Kontext geladenen Dokument (d.h. eingebettet in ein <iframe>), Zugang zu nicht partitionierten Cookies anzufordern, in Fällen, in denen Benutzeragenten standardmäßig den Zugang zu nicht partitionierten Cookies für Seiten, die in einem Drittanbieter-Kontext geladen werden, blockieren, um die Privatsphäre zu verbessern.
Document.requestStorageAccessFor() Experimentell: Ermöglicht Spitzen-Websites, den Cookie-Zugang Dritter im Namen eingebetteter Inhalte zu beantragen, die von einer anderen Website im selben related website set stammen.
Document.startViewTransition(): Startet einen neuen Ansichtsübergang und gibt ein ViewTransition Objekt zurück, um es darzustellen.

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 Interface HTMLDocument oder wird für solche Dokumente erweitert:

Document.clear() Veraltet: Diese Methode tut nichts.
Document.close(): Schließt einen Dokumentstrom zum Schreiben.
Document.execCommand() Veraltet: Führt auf 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 Dokumentstrom 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 Textzeile in ein Dokument.

Statische Methoden

Dieses Interface erbt auch von den Interfaces Node und EventTarget.

Document.parseHTML() Experimentell: Erstellt ein neues Document Objekt aus einer HTML-Zeichenkette in einer XSS-sicheren Weise mit Sanitierung.
Document.parseHTMLUnsafe(): Erstellt ein neues Document Objekt aus einer HTML-Zeichenkette, ohne Sanitierung durchzuführen. Die Zeichenkette kann deklarative Schattenwurzeln enthalten.

Ereignisse

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

afterscriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> Element das Ausführen seines Skripts beendet.
beforescriptexecute Nicht standardisiert Veraltet: Wird ausgelöst, wenn ein statisches <script> Element kurz davor ist, das Ausführen zu starten.
prerenderingchange Experimentell: Wird auf einem prerendered Dokument ausgelöst, wenn es aktiviert wird (d.h. der Benutzer die Seite anzeigt).
securitypolicyviolation: Wird ausgelöst, wenn eine Inhalts-Sicherheitsrichtlinie verletzt wird.
visibilitychange: Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar oder verborgen geworden 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 auftritt, in den oder aus dem Vollbildmodus zu wechseln.

Lade- & Entlade- Ereignisse

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 das readyState Attribut eines Dokuments geändert wurde.

Pointer Lock-Ereignisse

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

Scroll-Ereignisse

scroll: Wird ausgelöst, wenn die Dokumentansicht oder ein Element gescrollt wurde.
scrollend: Wird ausgelöst, wenn die Dokumentansicht oder ein Element das Scrollen abgeschlossen hat.
scrollsnapchange Experimentell: Wird ausgelöst am Scrollcontainer am Ende eines Scrollvorgangs, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging Experimentell: Wird ausgelöst am Scrollcontainer, 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.

Gebubblete Ereignisse

Nicht alle Ereignisse, die bubbbeln, können das Document Objekt erreichen. Nur folgende tun dies und können auf dem Document Objekt abgehö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