Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

`Document.body` y `Document.title`: contenido y título de la página

Usa `document.body` para acceder al elemento que contiene el contenido de la página y `document.title` para leer o cambiar el texto del título.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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 es una forma abreviada de referirse a dos propiedades de la interfaz Document, no una sintaxis que se use en el código. En un script de una página, document es el objeto del documento actual. Las dos propiedades son API de la plataforma web, no de ECMAScript 2024. Un entorno sin DOM no tiene por qué ofrecer document.

document.body devuelve el primer hijo directo del elemento html que sea un body o un frameset obsoleto. Si no lo hay, devuelve null. Durante el análisis del HTML puede que el cuerpo aún no exista: comprueba que esté presente antes de usarlo o ejecuta el código después del análisis, por ejemplo en un manejador de DOMContentLoaded registrado antes de que se dispare el evento.

Para agregar contenido sin reemplazar todo el elemento, usa document.body.append(node). Al asignar otro elemento body o frameset, se sustituye el existente junto con su subárbol o, si aún no existe, se inserta el nuevo bajo el elemento raíz. Asignar null no elimina el cuerpo: lanza HierarchyRequestError. También se lanza esa excepción si no hay un elemento raíz bajo el que insertar el nuevo elemento.

document.title devuelve una cadena, no un elemento ni un encabezado h1. Al leerlo, se eliminan los caracteres de espacio en blanco ASCII de los extremos y se reduce cada secuencia interna a un solo espacio. En HTML, si falta title, se obtiene una cadena vacía. La asignación actualiza el texto del título sin interpretarlo como HTML y normalmente cambia la etiqueta de la pestaña de una página abierta. Si falta title pero existe head, crea un title dentro de head; si faltan ambos, no hace nada. Un documento con un elemento SVG svg como raíz usa un title del espacio de nombres SVG como hijo directo de esa raíz.

Ejemplos

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

Resultado

Study notes
Review the DOM.

Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y consulta la consola de las herramientas de desarrollo. El script crea un documento aparte, así que no cambia el contenido de la página abierta ni el título de su pestaña.

Lecciones relacionadas

  • JavaScript · Lección 36 · Intermedio · Versión: 3

Fuentes