W3cubDocs

/Web APIs

Text: wholeText property

The read-only wholeText property of the Text interface returns the full text of all Text nodes logically adjacent to the node. The text is concatenated in document order. This allows specifying any text node and obtaining all adjacent text as a single string.

Note: This is similar to call Node.normalize() followed by reading the text value, but without modifying the tree.

Value

A string with the concatenated text.

Example

Suppose you have the following simple paragraph within your webpage:

html

<p>
  Through-hiking is great!
  <strong>No insipid election coverage!</strong> However,
  <a href="https://en.wikipedia.org/wiki/Absentee_ballot">casting a ballot</a>
  is tricky.
</p>

You decide you don't like the middle sentence, so you remove it:

js

const paragraph = document.querySelector("p"); // Reads the paragraph
paragraph.removeChild(para.childNodes[1]); // Delete the strong element

Now you end up with "Through-hiking is great! However, casting a ballot is tricky.", with two nodes before the hyperlink:

  1. A Text containing the string "Through-hiking is great!"
  2. A second Text node containing the string " However, "

To get those two nodes at once, you would call para.childNodes[0].wholeText:

js

console.log(`'${paragraph.childNodes[0].wholeText}'`); // 'Through-hiking is great!   However, '

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
wholeText 2 12 3.5 9 ≤12.1 4 4.4 18 4 ≤12.1 3.2 1.0

See also

  • The Text interface it belongs to.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Text/wholeText