Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Document.title — ler e alterar o título do documento

Document.title permite ler e definir o título de um documento. Ao ler, normaliza os espaços em branco ASCII.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

document.title;
document.title = "New title";

Document.title é uma propriedade gravável da Web API, não uma função ECMAScript. Utilize document.title para ler e atribuir um valor.

Em HTML, utiliza o primeiro elemento title pela ordem da árvore. Ao ler, remove os espaços em branco ASCII no início e no fim e substitui as sequências por espaços únicos; se não existir título, devolve "".

A atribuição substitui o texto, sem interpretar HTML. Se title não existir, cria-o em head; se ambos os elementos não existirem, nada muda.

Num documento cuja raiz seja um svg SVG, utiliza o primeiro elemento SVG title filho direto e cria-o durante a atribuição, caso não exista. O exemplo requer um ambiente de navegador.

Exemplos

const doc = document.implementation.createHTMLDocument("");
doc.title = "  Learning\n  JavaScript  ";
console.log(JSON.stringify(doc.title));

Resultado

"Learning JavaScript"

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes