Skip to main content

Cypress next Command

The next command in cypress fetches the immediate following sibling of the DOM element provided in the get command previously. It yields the new DOM element(s) it found.


.next(selector, options)

Arguments Used In Next:

  • Selector: This is an argument used in the next command to filter matching DOM elements.
  • Options: In Options we pass in log and timeout object to change the default behavior of next().
    • Log: Displays the command in the command log, and the default value is true.
    • Timeout: Time to wait till the next command resolves before timing out.


  1. Next requires to be chained off a command that yields DOM elements. It can not be directly chained with Cy or the command like getCookies which does not yield DOM elements.
  2. It will automatically retry until the elements exist in DOM.
  3. Next will automatically retry until all chained assertions have passed.
  4. It can timeout, waiting for the elements to exist in the DOM.
  5. Next can time out waiting for assertions you've added to pass.


For a real-time example, we will try to automate our traditional page.

Cypress Next Example

Example: Get Next Element

Get the Enter your ProgramsBuzz username element which is next sibling to username input

 it.only('next command', () => {
    const userTxt = cy.get('#edit-name').next()

Example: Get Next Element With Selector

Get the Enter your ProgramsBuzz username element using next and locator

it.only('next command', () => {
    cy.get('div.form-item-name [class]').next('.description')

    Video Tutorial: Cypress Next Command

    Submitted by arilio666 on June 3, 2022

    Ashwin is working with iVagus as a Technical Lead. He has experience in various technologies like Cypress, JavaScript, TypeScript, Rest Assured, Selenium, Cucumber, and Java.


    At ProgramsBuzz, you can learn, share and grow with millions of techie around the world from different domain like Data Science, Software Development, QA and Digital Marketing. You can ask doubt and get the answer for your queries from our experts.