cy.parent() and cy.children() in Cypress

Introduction

These commands help you find related elements on a webpage. cy.parent() finds the parent of an element, and cy.children() finds all direct children of an element.

When you want to check the container of a button or link.

When you need to verify all items inside a list or menu.

When you want to move from a child element to its parent to check styles or attributes.

When you want to test if a parent element contains the correct children.

When you want to chain commands to navigate the page structure easily.

Syntax

Cypress

cy.get('selector').parent()
cy.get('selector').children()

cy.parent() returns the immediate parent element of the matched element.

cy.children() returns all direct child elements of the matched element.

Examples

This finds the parent element of the first button found on the page.

Cypress

cy.get('button').parent()

This finds all direct child elements (usually li) inside the ul list.

Cypress

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

This checks if the parent of an element with class item has the class container.

Cypress

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

This verifies that the element with id menu has exactly 5 direct children.

Cypress

cy.get('#menu').children().should('have.length', 5)

Sample Program

This test visits a sample page. The first test finds an element with class traversal-badge and checks if its parent has class traversal-button. The second test checks that the element with class traversal-list has exactly 5 children.

Cypress

describe('Test cy.parent() and cy.children()', () => {
  beforeEach(() => {
    cy.visit('https://example.cypress.io/commands/traversal')
  })

  it('checks parent element', () => {
    cy.get('.traversal-badge').parent().should('have.class', 'traversal-button')
  })

  it('checks children elements count', () => {
    cy.get('.traversal-list').children().should('have.length', 5)
  })
})

Important Notes

Always use specific selectors to avoid selecting wrong elements.

cy.parent() only goes one level up. To go higher, chain multiple parent() calls.

cy.children() only returns direct children, not deeper descendants.

Summary

cy.parent() finds the immediate parent of an element.

cy.children() finds all direct children of an element.

Use these commands to navigate and test the page structure easily.

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