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.
A string with the concatenated text.
Suppose you have the following simple paragraph within your webpage:
<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:
const paragraph = document.querySelector("p");
paragraph.removeChild(para.childNodes[1]);
Now you end up with "Through-hiking is great! However, casting a ballot is tricky.", with two nodes before the hyperlink:
- A
Text
containing the string "Through-hiking is great!"
- A second
Text
node containing the string " However, "
To get those two nodes at once, you would call para.childNodes[0].wholeText
:
console.log(`'${paragraph.childNodes[0].wholeText}'`);