Why cy.parent() and cy.children() in Cypress? - Purpose & Use Cases

The Big Idea

Discover how a simple command can save you hours of frustrating manual checks!

The Scenario

Imagine you are testing a webpage with many nested elements, like a list inside a menu inside a sidebar. You want to check if a specific item is inside the right parent container or if the parent has the correct style. Doing this by clicking around and visually checking each level is tiring and easy to miss.

The Problem

Manually checking parent or child elements means lots of guesswork and switching back and forth between the browser and notes. It's slow, you might miss a step, and it's hard to repeat exactly the same checks every time. This leads to bugs slipping through and wasted time.

The Solution

Using cy.parent() and cy.children() lets you directly ask Cypress to find the parent or children of an element in your test code. This makes your tests clear, fast, and reliable. You can easily check relationships between elements without guessing or clicking around.

Before vs After

✗ Before

cy.get('.item').then(el => {
  // manually find parent in DOM and check
  const parent = el[0].parentElement;
  expect(parent.classList.contains('menu')).to.be.true;
});

✓ After

cy.get('.item').parent().should('have.class', 'menu');

What It Enables

It enables writing simple, clear tests that check element relationships precisely and repeatably, saving time and catching bugs early.

Real Life Example

For example, when testing a dropdown menu, you can verify that the selected option's parent container has the correct styling or class to show it is active, ensuring the UI behaves as expected.

Key Takeaways

Manually checking element parents or children is slow and error-prone.

cy.parent() and cy.children() let you navigate element relationships easily in tests.

This makes tests faster, clearer, and more reliable.

Practice

1. What does the Cypress command cy.parent() do?

easy

A. Finds all child elements of the current element

B. Finds the immediate parent element of the current element

C. Finds all sibling elements of the current element

D. Finds the first child element of the current element

Solution

1. Step 1: Understand the purpose of cy.parent()

   This command is used to get the immediate parent of the currently selected element in the DOM tree.

2. Step 2: Compare with other options

   cy.children() finds children, siblings are not targeted by cy.parent(), and it does not find the first child specifically.

3. Final Answer:

   Finds the immediate parent element of the current element -> Option B

4. Quick Check:

   cy.parent() = immediate parent [OK]

Hint: Parent means one level up in the DOM tree [OK]

Common Mistakes:

• Confusing parent with children
• Thinking it finds all ancestors
• Assuming it finds siblings

2. Which of the following is the correct syntax to get all direct children of an element with class container in Cypress?

easy

A. cy.get('.container').children()

B. cy.get('.container').parent()

C. cy.get('.container').child()

D. cy.get('.container').parents()

Solution

1. Step 1: Identify the correct command for children

   The command to get direct children is children(), so cy.get('.container').children() is correct.

2. Step 2: Check other options for correctness

   parent() gets the parent, child() is not a valid Cypress command, and parents() gets all ancestors, not children.

3. Final Answer:

   cy.get('.container').children() -> Option A

4. Quick Check:

   children() gets direct children [OK]

Hint: Use children() to get direct children elements [OK]

Common Mistakes:

• Using parent() instead of children()
• Using incorrect method child()
• Confusing parents() with children()

3. Consider the following HTML structure:

<div class='grandparent'>
  <div class='parent'>
    <span class='child'>Hello</span>
    <span class='child'>World</span>
  </div>
</div>

What will cy.get('.child').parent().should('have.class', 'parent') assert?

medium

A. That the grandparent has class 'parent'

B. That the children of .parent have class 'child'

C. That the parent of each .child element has class 'parent'

D. That the .child elements have class 'parent'

Solution

1. Step 1: Understand the command chain

   cy.get('.child') selects both span elements. parent() gets their immediate parent, which is the div with class 'parent'.

2. Step 2: Analyze the assertion

   The assertion checks if the parent element has class 'parent', which is true for both .child elements.

3. Final Answer:

   That the parent of each .child element has class 'parent' -> Option C

4. Quick Check:

   parent() gets immediate parent with class 'parent' [OK]

Hint: parent() gets immediate parent element of selected children [OK]

Common Mistakes:

• Thinking parent() gets grandparent
• Confusing children with parent
• Assuming assertion checks children classes

4. You wrote this Cypress test:

cy.get('.list').children('.item').parent('.container')

But it fails with an error. What is the likely cause?

medium

A. The parent() command does not accept a selector argument

B. The children() command cannot filter by class

C. The parent() command returns all ancestors, not immediate parent

D. The children() command returns siblings, not children

Solution

1. Step 1: Check parent() usage

   The parent() command in Cypress does not accept any selector argument; it always returns the immediate parent element.

2. Step 2: Verify other commands

   children() can filter by selector, so that part is valid. parent() does not return all ancestors, only immediate parent. children() returns direct children, not siblings.

3. Final Answer:

   The parent() command does not accept a selector argument -> Option A

4. Quick Check:

   parent() takes no selector argument [OK]

Hint: parent() never takes a selector; children() can filter [OK]

Common Mistakes:

• Passing selector to parent()
• Confusing children() filtering
• Thinking parent() returns all ancestors

5. Given this HTML:

<ul class='menu'>
  <li class='item'>Home</li>
  <li class='item'>About</li>
  <li class='item'>Contact</li>
</ul>
<div class='footer'>Footer content</div>

Which Cypress command chain correctly selects the <ul> element starting from the <li> elements with class item?

hard

A. cy.get('.item').children('ul')

B. cy.get('.item').parent().parent()

C. cy.get('.item').children()

D. cy.get('.item').parent()

Solution

1. Step 1: Identify the parent of .item elements

   Each <li class='item'> is a direct child of the <ul class='menu'> element.

2. Step 2: Use parent() to get immediate parent

   cy.get('.item').parent() correctly gets the immediate parent <ul class='menu'> element.

3. Step 3: Check other options

   children('ul') is wrong because <li> elements do not have <ul> children. parent().parent() goes too far up. children() gets children, not parent.

4. Final Answer:

   cy.get('.item').parent() -> Option D

5. Quick Check:

   parent() gets immediate parent [OK]

Hint: Use parent() to get immediate parent element [OK]

Common Mistakes:

• Using children() to get parent
• Going two levels up unnecessarily
• Assuming children() returns parent