HTMLBodyElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The HTMLBodyElement interface provides special properties (beyond those inherited from the regular HTMLElement interface) for manipulating <body> elements.

EventTarget Node Element HTMLElement HTMLBodyElement

Instance properties

Inherits properties from its parent, HTMLElement.

A string that represents the color of active hyperlinks.

HTMLBodyElement.background Deprecated

A string that represents the description of the location of the background image resource. Note that this is not an URI, though some older version of some browsers do expect it.

HTMLBodyElement.bgColor Deprecated

A string that represents the background color for the document.

A string that represents the color of unvisited links.

HTMLBodyElement.text Deprecated

A string that represents the foreground color of text.

A string that represents the color of visited links.

Instance methods

No specific methods; inherits methods from its parent, HTMLElement.

Event handlers

The HTMLElement events are inherited.

The following Window onXYZ event handler properties are also available as aliases targeting the window object. However, it is advised to listen to them on the window object directly rather than on HTMLBodyElement.

Note: Using addEventListener() on HTMLBodyElement will not work for the onXYZ event handlers listed below. Listen to the events on the window object instead.

HTMLBodyElement.onafterprint

Fired after the associated document has started printing or the print preview has been closed.

HTMLBodyElement.onbeforeprint

Fired when the associated document is about to be printed or previewed for printing.

HTMLBodyElement.onbeforeunload

Fired when the window, the document and its resources are about to be unloaded.

HTMLBodyElement.ongamepadconnected

Fired when the browser detects that a gamepad has been connected or the first time a button/axis of the gamepad is used.

HTMLBodyElement.ongamepaddisconnected

Fired when the browser detects that a gamepad has been disconnected.

HTMLBodyElement.onhashchange

Fired when the fragment identifier of the URL has changed (the part of the URL beginning with and following the # symbol).

HTMLBodyElement.onlanguagechange

Fired when the user's preferred language changes.

HTMLBodyElement.onmessage

Fired when the window receives a message, for example from a call to Window.postMessage() from another browsing context.

HTMLBodyElement.onmessageerror

Fired when the window receives a message that can't be deserialized.

HTMLBodyElement.onoffline

Fired when the browser has lost access to the network and the value of Navigator.onLine switches to false.

HTMLBodyElement.ononline

Fired when the browser has gained access to the network and the value of Navigator.onLine switches to true.

HTMLBodyElement.onpagehide

Fired when the browser hides the current page in the process of presenting a different page from the session's history.

HTMLBodyElement.onpageshow

Fired when the browser displays the window's document due to navigation.

HTMLBodyElement.onpopstate

Fired when the active history entry changes while the user navigates the session history.

HTMLBodyElement.onrejectionhandled

Fired whenever a JavaScript Promise is rejected and the rejection has been handled.

HTMLBodyElement.onstorage

Fired when a storage area (localStorage) has been modified in the context of another document.

HTMLBodyElement.onunhandledrejection

Fired whenever a Promise is rejected but the rejection was not handled.

HTMLBodyElement.onunload

Fired when the document is being unloaded.

Specifications

Specification
HTML
# htmlbodyelement

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLBodyElement
aLink
Deprecated
background
Deprecated
bgColor
Deprecated
link
Deprecated
text
Deprecated
vLink
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

See also

  • HTML element implementing this interface: <body>