Die Eigenschaft document.title holt oder setzt den aktuellen Titel des Dokuments.
var docTitle = document.title;
docTitle ist eine Zeichenfolge, die den Titel des Dokuments enthält. Wenn der Titel durch das Setzen von document.title überschrieben wurde, enthält er diesen Wert. Andernfalls enthält er den im Markup angegebenen Titel (siehe {{Anch("Anmerkungen")}} unten).
document.title = newTitle;
newTitle ist der neue Titel des Dokuments. Die Zuweisung beeinflusst den Rückgabewert von document.title, den für das Dokument angezeigten Titel (z.B. in der Titelleiste des Fensters oder Tabs), und sie beeinflusst auch das DOM des Dokuments (z.B. den Inhalt des Elements <title> in einem HTML-Dokument).
<!DOCTYPE html>
<html>
<head>
<title>Hallo Welt!</title>
</head>
<body>
<script>
alert(document.title); // zeigt "Hallo Welt!"
document.title = "Tschüss Welt!";
alert(document.title); // zeigt "Tschüss Welt!"
</script>
</body>
</html>
Diese Eigenschaft gilt für HTML-, SVG-, XUL- und andere Dokumente in Gecko.
Bei HTML-Dokumenten ist der Anfangswert von document.title der Textinhalt des Elements <title>. Bei XUL ist es der Wert des {{XULAttr("title")}} Attributs des {{XULElem("window")}} oder eines anderen XUL-Elements der obersten Ebene.
In XUL hat der Zugriff auf document.title, bevor das Dokument vollständig geladen ist, ein undefiniertes Verhalten: document.title gibt möglicherweise eine leere Zeichenfolge zurück, und das Setzen von document.title hat möglicherweise keine Wirkung.
| Spezifikation | Status | Kommentar |
|---|---|---|
| {{SpecName('HTML WHATWG','#document.title','document.title')}} | {{Spec2('HTML WHATWG')}} |
{{Compat("api.Document.title")}}