JS: DOM API
2026-02-21 23:41 Diff
https://hexlet.io/courses/js-dom/lessons/search/theory_unit

In frontend tasks, you usually manipulate a set of elements located deep down in the DOM tree. Moreover, these elements are often scattered over different parts of it.

For example, we can mark a list of files for deletion and then perform deleting. If you look at it from the perspective of changing the DOM tree, this task boils down to select all the elements that represent files and then deleting them.

Search methods

In such a case, manually traversing through the tree will be tedious. DOM offers several ways to solve this problem at once. The simplest way to search is to search by ID:

According to the specification, there cannot be two identical id on a page. So, the getElementById() method always returns one element.

On the other hand, there is a chance there may be several tags with the same id in HTML. In this situation, the browser will return the first element it encounters.

If you need to process several elements at once, then search by a class is a better option:

If necessary, you can search by tags. It is rare in practical tasks, but still, it's useful to know about this method:

Search by selector

The most universal search method is a search by a selector. You may remember that a selector is a rule that allows you to describe a set of elements in a DOM tree:

We can apply both querySelector() and querySelectorAll() methods to the entire document or a specific element. The search will also go through all the descendants, as usual.

Other useful methods

matches

The predicate el.matches(css) checks whether el satisfies the css selector:

closest

The el.closest(css) method searches for the closest element higher up the hierarchy that satisfies the selector. The element itself is also analyzed. If such an element is found, it will be returned, otherwise null will be returned:

XPath

It is a query language, developed to navigate through DOM trees in XML. It is supported by browsers:

The XPath path /html/body/*/span/@class will correspond to two elements of the source document in it:

  • <span class="text"> the first block in the third layer</span>
  • <span class="text">the second block in the third layer</span>

In everyday work, programmers rarely use XPath when working with DOM, so we're only learning it here to show the whole picture. But if you're working with XML documents, XPath is the main way to navigate a document.