Document.body
The Document.body
property represents the
<body>
or <frameset>
node of the current document, or
null
if no such element exists.
Syntax
const objRef = document.body
document.body = objRef
Example
// Given this HTML: <body id="oldBodyElement"></body>
alert(document.body.id); // "oldBodyElement"
const aNewBodyElement = document.createElement("body");
aNewBodyElement.id = "newBodyElement";
document.body = aNewBodyElement;
alert(document.body.id); // "newBodyElement"
Notes
document.body
is the element that contains the content for the document.
In documents with <body>
contents, returns the
<body>
element, and in frameset documents, this returns the outermost
<frameset>
element.
Though the body
property is settable, setting a new body on a document
will effectively remove all the current children of the existing
<body>
element.
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'Document.body' in that specification. |
Living Standard | |
HTML 5.1 The definition of 'Document.body' in that specification. |
Recommendation | |
HTML5 The definition of 'Document.body' in that specification. |
Recommendation |
Browser compatibility
BCD tables only load in the browser