Course contentsShow
← Web Development
Lesson 711 of 2,98212. The Document Object ModelFree lesson

contains() for Descendant Checking

Determining whether one element is a descendant of another in the DOM tree.

contains() for Descendant Checking

What you'll learn: How to programmatically check if one element lives anywhere inside another element's DOM subtree.

The Core Idea

Sometimes you need to ask: "Is element B somewhere inside element A?" This is called a descendant check. The contains() method answers this question with a simple true or false.

Think of it like asking whether a specific room is somewhere inside a house. The room might be directly off the main hallway (a child), or it might be inside a wing, down a corridor, through another room (a deeply nested descendant). Either way, it's contained within the house.

How It Works

The syntax is straightforward:

parentElement.contains(possibleDescendant)

This returns true if possibleDescendant is anywhere within parentElement's DOM tree, and false otherwise. Importantly, an element contains itself — if you check element.contains(element), you'll get true.

Practical Example

const container = document.querySelector('.container');
const button = document.querySelector('.nested-button');
const outsideDiv = document.querySelector('.sidebar');

console.log(container.contains(button));      // true (if button is inside container)
console.log(container.contains(outsideDiv));  // false (if sidebar is elsewhere)
console.log(container.contains(container));   // true (self-reference)

When to Use It

This is particularly useful when:

  • Handling click events to check if a click happened inside a specific component
  • Validating relationships before moving elements
  • Building dropdown menus or modals that need to detect outside clicks

Key Takeaway: Use contains() to check if one element exists anywhere within another element's descendant tree, making it perfect for containment validation in interactive components.