当前位置：文江博客知识库 en-US 文档 Web API Document title

Document.title - Web APIs 编辑

The document.title property gets or sets the current title of the document.

Syntax

var docTitle = document.title;

docTitle is 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).

Example

<!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.