Document.title
The document.title
property gets
or sets the current title of the
document.
Value
A string containing the document's title. If the title was overridden by setting document.title
, it contains that value. Otherwise, it contains the title specified in the markup (see the Notes below).
document.title = newTitle;
newTitle
is the new title of the document. The assignment
affects the return value of document.title
, the title displayed for the
document (e.g. in the titlebar of the window or tab), and it also affects the DOM of the
document (e.g. the content of the <title>
element in an HTML
document).
Examples
<!DOCTYPE html>
<html>
<head>
<title>Hello World!</title>
</head>
<body>
<script>
alert(document.title); // displays "Hello World!"
document.title = "Goodbye World!";
alert(document.title); // displays "Goodbye World!"
</script>
</body>
</html>
Notes
This property applies to HTML, SVG, XUL, and other documents in Gecko.
For HTML documents the initial value of document.title
is the text content
of the <title>
element. For XUL it's the value of the
title
attribute of the <xul:window>
or other top-level XUL
element.
In XUL, accessing document.title
before the document is fully loaded has
undefined behavior: document.title
may return an empty string and setting
document.title
may have no effect.
Specifications
Specification |
---|
HTML Standard # document.title |
Browser compatibility
BCD tables only load in the browser