HTMLBodyElement
===============

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

EventTarget

Node

Element

HTMLElement

HTMLBodyElementInstance properties
-------------------

*Inherits properties from its parent, `HTMLElement`.*

`HTMLBodyElement.aLink` 
Deprecated

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.

`HTMLBodyElement.link` 
Deprecated

A string that represents the color of unvisited links.

`HTMLBodyElement.text` 
Deprecated

A string that represents the foreground color of text.

`HTMLBodyElement.vLink` 
Deprecated

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 Standard # htmlbodyelement |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* HTML element implementing this interface: `<body>`