Firefox Tomorrow

web api instance property

HTMLElement: outerText property

View on MDN ↗

The outerText property of the HTMLElement interface returns the same value as innerText. When used as a setter it replaces the whole current node with the given text (this differs from innerText, which replaces the content inside the current node).

See innerText for more information and examples showing how both properties are used as getters.

Value

A string representing the rendered text content of an element and its descendants.

If the element itself is not being rendered (for example, is detached from the document or is hidden from view), the returned value is the same as the textContent property.

When used as a setter it replaces the current node with the given text, converting any line breaks into <br> elements.

Examples

This example highlights the fundamental difference between outerText and innerText when used as setters (they are the same when used by getters).

[!NOTE] The example is a modified version of What is the difference between innerText and outerText? (Stack overflow) by codingintrigue, is licensed under CC BY-SA 3.0.

Consider a page that contains the following HTML:

<div>
  <p>Original content</p>
</div>

outerText replaces the whole selected element, so the JavaScript p.outerText = "Whole element replaced" replaces the whole selected p element:

<div>Whole element replaced</div>

By contrast, p.innerText = "Content inside element replaced" replaces the content inside the selected p element:

<div>
  <p>Content inside element replaced</p>
</div>

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also