JS: DOM Whitespace Nodes

By Xah Lee. Date: . Last updated: .

Whitespace characters in HTML source code between elements are considered a node too. (whitespace includes space, newline, tab)

For example, if you have:

<ul id="x1">

And you count the number of the ul's children nodes, you get 5.

); // prints 5

because the newline characters in between tags are also considered nodes.

Here's another example, you can try in browser console:

// example of testing whitespace node

// get the next node after the first paragraph
var xx = document.getElementsByTagName("p")[0].nextSibling;

xx.nodeType; // 3 means text node (whitespace node)

xx.nodeValue; // if whitespace node, then result is space or newline or tab, etc.

〔►see JS: Node Type, Node Name, Node Value

How to Skip Whitespace Nodes

Use a property that skip the whitespace nodes.

no whitespace nodecontains whitespace node

Those “no whitespace” versions are newer, but is supported by all browsers today.

〔►see JS: Navigate DOM Tree


In XML, all whitespace has to be passed through to the application. This means that if you have whitespace, such as carriage returns, between tags in your source file, these have to be passed through, even if they're just there for pretty-printing. The DOM implementation has to put this whitespace somewhere, and the only possibility is a text node. Thus you will get text nodes which look empty, but in fact have a carriage return or other whitespace in them.

Note that some DOM implementations, which do not consider whitespace in element content to be meaningful for the XML languages they support, discard these whitespace nodes before exposing the DOM to their users.

[from http://www.w3.org/DOM/faq.html#emptytext]

There are many more Text nodes in the DOM tree than one would initially expect, because the source contains a number of spaces (represented here by "␣") and line breaks ("⏎") that all end up as Text nodes in the DOM.

However, for historical reasons not all of the spaces and line breaks in the original markup appear in the DOM. In particular, all the whitespace before head start tag ends up being dropped silently, and all the whitespace after the body end tag ends up placed at the end of the body.

[ from (https://developers.whatwg.org/introduction.html#a-quick-introduction-to-html)]

back to JS: Navigate DOM Tree

Web Scripting Overview Topic

  1. JS: Browser Window Object, Document Object Model
  2. JS: Intro to Event-Based Programing
  3. JavaScript Execution Order
  4. JS: What Does Live Object Mean?
  5. JS: Array vs NodeList vs HTMLCollection
  6. JS: DOM Whitespace Nodes
Like what you read? Buy JavaScript in Depth