WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`Document.body` und `Document.title`: Seiteninhalt und Titel

Mit `document.body` greifst du auf das Inhaltselement der Seite zu. Mit `document.title` liest oder änderst du den Titeltext des Dokuments.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

doc.body              // Read: HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = bodyElement // Write: supply an HTML body or frameset element
 doc.title             // Read: string
 doc.title = titleText // Write: supply title text

Document.body/title steht als Kurzform für zwei Eigenschaften der Schnittstelle Document und ist keine gültige Schreibweise im Code. In einem Seitenskript ist document das aktuelle Dokumentobjekt. Beide Eigenschaften gehören zur Webplattform, nicht zu ECMAScript 2024. Eine Laufzeit ohne DOM muss kein document bereitstellen.

document.body liefert das erste direkte Kind des html-Elements, das ein body oder ein veraltetes frameset ist. Gibt es kein solches Kind, liefert die Eigenschaft null. Während des Parsens ist das body-Element möglicherweise noch nicht vorhanden. Prüfe deshalb vor dem Zugriff, ob es existiert, oder führe den Code erst nach dem Parsen aus, etwa in einem vorab registrierten Handler für DOMContentLoaded.

Mit document.body.append(node) fügst du Inhalt hinzu, ohne das ganze Element auszutauschen. Die Zuweisung eines anderen body- oder frameset-Elements ersetzt das vorhandene Element samt Teilbaum. Ist noch keines vorhanden, wird das neue Element unter dem Wurzelelement eingefügt. Die Zuweisung von null entfernt den Inhalt nicht, sondern löst HierarchyRequestError aus. Diese Ausnahme tritt auch auf, wenn das Wurzelelement zum Einfügen fehlt.

document.title liefert eine Zeichenkette, kein Element und keine h1-Überschrift. Beim Lesen werden ASCII-Leerraumzeichen an den Rändern entfernt und Folgen im Inneren auf einzelne Leerzeichen reduziert. Fehlt in HTML ein title-Element, ist das Ergebnis die leere Zeichenkette. Eine Zuweisung ändert den Titeltext, ohne ihn als HTML zu parsen, und ändert bei einer geöffneten Seite üblicherweise die Tab-Beschriftung. Fehlt title, aber head ist vorhanden, wird in head ein title angelegt; fehlen beide, bleibt die Zuweisung wirkungslos. Ein Dokument mit einem SVG-svg als Wurzelelement verwendet ein separates title im SVG-Namensraum direkt unter dieser Wurzel.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.body and Document.title example</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    doc.title = "  Study   notes  ";

    const paragraph = doc.createElement("p");
    paragraph.textContent = "Review the DOM.";
    doc.body.append(paragraph);

    console.log(doc.title);
    console.log(doc.body.textContent);
  </script>
</body>
</html>

Ergebnis

Study notes
Review the DOM.

Speichere das Beispiel als `.html`-Datei, öffne es im Browser und prüfe die Ausgabe in der Konsole der Entwicklertools. Das Skript erstellt ein separates Dokument und ändert weder den Inhalt der geöffneten Seite noch deren Tab-Titel.

Zugehörige Lektionen

  • JavaScript · Lektion 36 · Mittlere Stufe · Version: 3

Quellen