Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

Die Document-Schnittstelle repräsentiert jede im Browser geladene Webseite und dient als Einstiegspunkt in den Inhalt der Webseite, also den DOM-Baum.

Der DOM-Baum umfasst unter vielen anderen Elemente wie <body> und <table>. Er stellt dokumentweit Funktionalität bereit, beispielsweise zum Abrufen der URL der Seite und zum Erstellen neuer Elemente im Dokument.

EventTarget Node Document

Die Document-Schnittstelle beschreibt die gemeinsamen Eigenschaften und Methoden für jede Art von Dokument. Abhängig vom Dokumenttyp (z. B. HTML, XML, SVG, …) ist eine umfangreichere API verfügbar: HTML-Dokumente, die mit dem Content-Type "text/html" bereitgestellt werden, implementieren auch die Schnittstelle HTMLDocument, während XML- und SVG-Dokumente die Schnittstelle XMLDocument implementieren.

Konstruktor

Document()

Erstellt ein neues Document-Objekt.

Instanzeigenschaften

Diese Schnittstelle erbt außerdem von den Schnittstellen 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 im Dokument aktiven View Transition repräsentiert, oder null, wenn kein View Transition aktiv ist.

Document.adoptedStyleSheets

Fügt ein Array konstruierter Stylesheets hinzu, die vom Dokument verwendet werden sollen. Diese Stylesheets können auch mit Shadow-DOM-Teilbäumen desselben Dokuments geteilt werden.

Document.body

Gibt den Knoten <body> oder <frameset> des aktuellen Dokuments zurück.

Document.characterSet Schreibgeschützt

Gibt den vom Dokument verwendeten 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

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 gerade verarbeitet wird und das kein JavaScript-Modul ist.

Document.customElementRegistry Schreibgeschützt

Das diesem Dokument zugeordnete CustomElementRegistry-Objekt 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. 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 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 angewendeten Feature Policies zurück.

Document.firstElementChild Schreibgeschützt

Gibt das erste Kindelement 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 sich derzeit für dieses Dokument im Vollbildmodus befindet.

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 verborgen gilt oder nicht.

Document.images Schreibgeschützt

Gibt eine HTMLCollection der Bilder im Dokument zurück.

Document.implementation Schreibgeschützt

Gibt die dem aktuellen Dokument zugeordnete DOM-Implementierung zurück.

Document.lastElementChild Schreibgeschützt

Gibt das letzte Kindelement des aktuellen Dokuments zurück.

Gibt eine HTMLCollection der Hyperlinks im Dokument zurück.

Document.pictureInPictureElement Schreibgeschützt

Gibt das Element zurück, das derzeit in diesem Dokument im Picture-in-Picture-Modus dargestellt wird.

Document.pictureInPictureEnabled Schreibgeschützt

Gibt true zurück, wenn die Picture-in-Picture-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 Sperrung aussteht, der Zeiger nicht gesperrt ist oder sich das Ziel in einem anderen Dokument befindet.

Document.prerendering Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das Dokument derzeit vorgeladen wird, 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 von CSSStyleSheet-Objekten für Stylesheets zurück, die explizit mit einem Dokument verknüpft 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 Sichtbarkeitsstatus des Dokuments bezeichnet. Mögliche Werte sind visible, hidden und unloaded.

Erweiterungen für HTMLDocument

Die Document-Schnittstelle für HTML-Dokumente erbt von der HTMLDocument-Schnittstelle 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 Window-Objekt zurück.

Document.designMode

Ruft die Möglichkeit ab bzw. legt sie fest, das gesamte Dokument zu bearbeiten.

Document.dir

Ruft die Schreibrichtung (rtl/ltr) des Dokuments ab bzw. legt sie fest.

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

Document.referrer Schreibgeschützt

Gibt die URI der Seite zurück, die auf diese Seite verlinkt hat.

Document.title

Legt den Titel des aktuellen Dokuments fest oder ruft ihn ab.

Document.URL Schreibgeschützt

Gibt den Speicherort des Dokuments als Zeichenfolge zurück.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften verfügbar gemacht:

  • Für jedes <embed>-, <form>-, <iframe>-, <img>- und <object>-Element wird sein name verfügbar gemacht, sofern er nicht leer ist. Wenn das Dokument beispielsweise <form name="my_form"> enthält, 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 verfügbar gemacht, sofern sie nicht leer ist.
  • Für jedes <img>-Element mit nicht leerem name wird seine id verfügbar gemacht, sofern sie nicht leer ist.

Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Ist dieses einzelne Element ein iframe, wird stattdessen sein contentWindow zurückgegeben. Entspricht die Eigenschaft mehreren Elementen, wird eine HTMLCollection zurückgegeben, die alle enthält.

Veraltete Eigenschaften

Document.alinkColor

Gibt die Farbe aktiver Links im Dokumentkörper zurück oder legt sie fest.

Document.all

Ermöglicht Zugriff auf alle Elemente im Dokument — sie gibt eine am Dokumentknoten verankerte HTMLAllCollection zurück. Dies ist eine Legacy-Eigenschaft, die nicht standardisiert ist und nicht verwendet werden sollte.

Document.anchors Schreibgeschützt

Gibt eine Liste aller Anker im Dokument zurück.

Document.applets Schreibgeschützt

Gibt eine leere HTMLCollection zurück. Legacy-Eigenschaft, die früher die Liste der Applets innerhalb eines Dokuments zurückgab.

Document.bgColor

Ruft die Hintergrundfarbe des aktuellen Dokuments ab bzw. legt sie fest.

Document.charset Schreibgeschützt

Alias von Document.characterSet. Verwenden Sie stattdessen diese Eigenschaft.

Document.domain

Ruft die Domain des aktuellen Dokuments ab bzw. legt sie fest.

Document.fgColor

Ruft die Vordergrund- oder Textfarbe des aktuellen Dokuments ab bzw. legt sie fest.

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 Festlegen des Werts von selectedStyleSheetSet geändert wird.

Document.linkColor

Ruft die Farbe von Hyperlinks im Dokument ab bzw. legt sie fest.

Document.preferredStyleSheetSet Schreibgeschützt

Gibt das vom Seitenautor angegebene bevorzugte Stylesheet-Set zurück.

Document.rootElement

Wie Document.documentElement, jedoch nur für <svg>-Stammelemente. 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 besuchter Hyperlinks ab bzw. legt sie fest.

Document.xmlEncoding

Gibt die durch die XML-Deklaration bestimmte Kodierung zurück.

Document.xmlStandalone

Gibt true zurück, wenn die XML-Deklaration das Dokument als eigenständig angibt (z. B. wenn ein externer Teil der DTD den Inhalt des Dokuments beeinflusst), andernfalls false.

Document.xmlVersion

Gibt die in der XML-Deklaration angegebene Versionsnummer oder "1.0" zurück, wenn die Deklaration fehlt.

Instanzmethoden

Diese Schnittstelle erbt außerdem von den Schnittstellen Node und EventTarget.

Document.adoptNode()

Übernimmt 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()

Legt fest, dass eine angegebene Textzeichenfolge von einem Screenreader angesagt werden soll.

Document.browsingTopics()

Gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die die wichtigsten Themen für den Benutzer repräsentieren, jeweils eines aus jeder der letzten drei Epochen. Standardmäßig bewirkt die Methode außerdem, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, sodass der Hostname der Seite später bei der Themenberechnung verwendet werden kann. Weitere Einzelheiten finden Sie in der Topics API.

Document.captureEvents()

Siehe Window.captureEvents.

Document.caretPositionFromPoint()

Gibt ein CaretPosition-Objekt zurück, das den DOM-Knoten enthält, der die Einfügemarke enthält, sowie den Zeichenoffset der Einfügemarke 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 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 angegebenen Tag-Namen.

Document.createElementNS()

Erstellt ein neues Element mit dem angegebenen Tag-Namen und der 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 Vollbildanzeige des Vollbildelements des Dokuments.

Document.exitPictureInPicture()

Entfernt das Video aus dem schwebenden Picture-in-Picture-Fenster und führt es zurück in seinen ursprünglichen Container.

Document.exitPointerLock()

Hebt die Zeigersperre auf.

Document.getAnimations()

Gibt ein Array aller derzeit wirksamen Animation-Objekte zurück, deren Zielelemente Nachfahren von document sind.

Document.getBoxQuads()

Gibt eine Liste von DOMQuad-Objekten zurück, die die CSS-Fragmente des Knotens repräsentieren.

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 der Einfügemarke repräsentiert.

Document.hasPrivateToken()

Gibt ein Promise zurück, das mit einem booleschen Wert erfüllt wird, der angibt, ob der Browser ein Private State Token eines bestimmten Ausstellers gespeichert hat.

Document.hasRedemptionRecord()

Gibt ein Promise zurück, das mit einem booleschen Wert erfüllt wird, der angibt, ob der Browser einen Einlösungsdatensatz gespeichert hat, der von einem bestimmten Aussteller stammt.

Document.hasStorageAccess()

Gibt ein Promise zurück, das mit einem booleschen Wert aufgelöst wird, der angibt, ob das Dokument Zugriff auf nicht partitionierte 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 angegebenen Node innerhalb des Document-DOM-Knotens als direktes Kind vor einen angegebenen Referenzknoten, ohne den Knoten zuerst zu entfernen und dann einzufügen.

Document.mozSetImageElement()

Ermöglicht das Ändern des Elements, das als Hintergrundbild für eine angegebene 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 Element-Knoten innerhalb des Dokuments in Dokumentreihenfolge zurück, der den angegebenen Selektoren entspricht.

Document.querySelectorAll()

Gibt eine Liste aller Element-Knoten innerhalb des Dokuments zurück, die den angegebenen Selektoren entsprechen.

Document.releaseCapture()

Gibt die aktuelle Mauseingabenerfassung 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 eine angegebene neue Menge von Kindern.

Document.requestStorageAccess()

Ermöglicht einem in einem Drittanbieter-Kontext geladenen Dokument (d.h. eingebettet in ein <iframe>), den Zugriff auf nicht partitionierte Cookies anzufordern, wenn User Agents standardmäßig den Zugriff auf nicht partitionierte Cookies durch Websites blockieren, die in einem Drittanbieter-Kontext geladen wurden, um den Datenschutz zu verbessern.

Document.requestStorageAccessFor()

Ermöglicht Websites der obersten Ebene, im Namen eingebetteter Inhalte, die von einer anderen Website im selben zusammengehörigen Website-Set stammen, Zugriff auf Drittanbieter-Cookies anzufordern.

Document.startViewTransition()

Startet einen neuen View Transition und gibt ein ViewTransition-Objekt zurück, das ihn repräsentiert.

Die Document-Schnittstelle wird um die XPathEvaluator-Schnittstelle erweitert:

Document.createExpression()

Kompiliert einen XPathExpression, der anschließend für (wiederholte) Auswertungen verwendet werden kann.

Document.createNSResolver()

Gibt den Eingabeknoten unverändert zurück.

Document.evaluate()

Wertet einen XPath-Ausdruck aus.

Erweiterung für HTML-Dokumente

Die Document-Schnittstelle für HTML-Dokumente erbt von der HTMLDocument-Schnittstelle oder wird für solche Dokumente erweitert:

Document.clear()

Diese Methode tut nichts.

Document.close()

Schließt einen Dokumentstream zum Schreiben.

Document.execCommand()

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()

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

Diese Schnittstelle erbt außerdem von den Schnittstellen Node und EventTarget.

Document.parseHTML()

Erstellt auf XSS-sichere Weise mit Sanitization ein neues Document-Objekt aus einer HTML-Zeichenfolge.

Document.parseHTMLUnsafe()

Erstellt ein neues Document-Objekt aus einer HTML-Zeichenfolge, ohne eine Sanitization durchzuführen. Die Zeichenfolge kann deklarative Shadow Roots enthalten.

Ereignisse

Überwachen Sie diese Ereignisse mit addEventListener() oder indem Sie der oneventname-Eigenschaft dieser Schnittstelle einen Event Listener zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von Knoten, die im Dokumentbaum enthalten sind, nach oben propagieren.

afterscriptexecute

Wird ausgelöst, wenn ein statisches <script>-Element die Ausführung seines Skripts beendet.

beforescriptexecute

Wird ausgelöst, wenn ein statisches <script>-Element kurz davor ist, mit der Ausführung zu beginnen.

prerenderingchange

Wird bei einem vorgeladenen Dokument ausgelöst, wenn es aktiviert wird (d.h. wenn der Benutzer die Seite aufruft).

securitypolicyviolation

Wird ausgelöst, wenn gegen eine Content Security Policy verstoßen wird.

visibilitychange

Wird ausgelöst, wenn der Inhalt eines Tabs sichtbar geworden ist oder ausgeblendet wurde.

Vollbildereignisse

fullscreenchange

Wird ausgelöst, wenn das Document in den Vollbildmodus wechselt oder ihn verlässt.

fullscreenerror

Wird ausgelöst, wenn beim Versuch, in den Vollbildmodus zu wechseln oder ihn zu verlassen, ein Fehler 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 werden.

readystatechange

Wird ausgelöst, wenn sich das readyState-Attribut eines Dokuments geändert hat.

Zeigersperrereignisse

pointerlockchange

Wird ausgelöst, wenn der Zeiger gesperrt bzw. entsperrt wird.

pointerlockerror

Wird ausgelöst, wenn das Sperren des Zeigers fehlgeschlagen ist.

Scrollereignisse

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

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 ansteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Auswahlereignisse

selectionchange

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

Nach oben propagierte Ereignisse

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