{
  "doc": {
    "id": "api/commands/find",
    "title": "cy.find()",
    "description": "Get the descendant DOM elements that match a selector in Cypress.",
    "section": "api",
    "source_path": "/llm/markdown/api/commands/find.md",
    "version": "5a232a3cf094b8f928b1179ce5af6a5046296fac",
    "updated_at": "2026-11-13T01:14:31.437Z",
    "headings": [
      {
        "id": "api/commands/find#find",
        "text": "find",
        "level": 1
      },
      {
        "id": "api/commands/find#syntax",
        "text": "Syntax",
        "level": 2
      },
      {
        "id": "api/commands/find#usage",
        "text": "Usage",
        "level": 3
      },
      {
        "id": "api/commands/find#arguments",
        "text": "Arguments",
        "level": 3
      },
      {
        "id": "api/commands/find#yields",
        "text": "Yields",
        "level": 3
      },
      {
        "id": "api/commands/find#examples",
        "text": "Examples",
        "level": 2
      },
      {
        "id": "api/commands/find#selector",
        "text": "Selector",
        "level": 3
      },
      {
        "id": "api/commands/find#find-the-li-elements-inside-a-parent-with-find",
        "text": "Find the li elements inside a parent with .find()",
        "level": 4
      },
      {
        "id": "api/commands/find#find-direct-children-with-a-leading-in-find",
        "text": "Find direct children with a leading > in .find()",
        "level": 4
      },
      {
        "id": "api/commands/find#assertions",
        "text": "Assertions",
        "level": 3
      },
      {
        "id": "api/commands/find#assert-on-the-number-of-elements-find-yields",
        "text": "Assert on the number of elements .find() yields",
        "level": 4
      },
      {
        "id": "api/commands/find#assert-that-find-no-longer-finds-an-element",
        "text": "Assert that .find() no longer finds an element",
        "level": 4
      },
      {
        "id": "api/commands/find#options",
        "text": "Options",
        "level": 3
      },
      {
        "id": "api/commands/find#wait-longer-for-slow-content-with-timeout",
        "text": "Wait longer for slow content with timeout",
        "level": 4
      },
      {
        "id": "api/commands/find#find-elements-inside-a-shadow-root-with-includeshadowdom",
        "text": "Find elements inside a shadow root with includeShadowDom",
        "level": 4
      },
      {
        "id": "api/commands/find#notes",
        "text": "Notes",
        "level": 2
      },
      {
        "id": "api/commands/find#find-only-searches-below-the-subject",
        "text": ".find() only searches below the subject",
        "level": 3
      },
      {
        "id": "api/commands/find#subjects-with-multiple-elements",
        "text": "Subjects with multiple elements",
        "level": 3
      },
      {
        "id": "api/commands/find#find-compared-to-within",
        "text": ".find() compared to .within()",
        "level": 3
      },
      {
        "id": "api/commands/find#reading-a-find-timeout-error",
        "text": "Reading a .find() timeout error",
        "level": 3
      },
      {
        "id": "api/commands/find#shadow-dom-boundaries-and-find",
        "text": "Shadow DOM boundaries and .find()",
        "level": 3
      },
      {
        "id": "api/commands/find#rules",
        "text": "Rules",
        "level": 2
      },
      {
        "id": "api/commands/find#requirements",
        "text": "Requirements",
        "level": 3
      },
      {
        "id": "api/commands/find#assertions",
        "text": "Assertions",
        "level": 3
      },
      {
        "id": "api/commands/find#timeouts",
        "text": "Timeouts",
        "level": 3
      },
      {
        "id": "api/commands/find#command-log",
        "text": "Command Log",
        "level": 2
      },
      {
        "id": "api/commands/find#history",
        "text": "History",
        "level": 2
      },
      {
        "id": "api/commands/find#see-also",
        "text": "See also",
        "level": 2
      }
    ]
  },
  "content": {
    "type": "root",
    "children": [
      {
        "type": "heading",
        "depth": 1,
        "children": [
          {
            "type": "text",
            "value": "find"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Get the descendant DOM elements that match a selector."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "`.find()` searches every level below the subject, as opposed to "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/children.md",
            "children": [
              {
                "type": "text",
                "value": "`.children()`"
              }
            ]
          },
          {
            "type": "text",
            "value": ", which only looks one level down."
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Syntax"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": ".find(selector)\n.find(selector, options)"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Usage"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Correct Usage"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('.article').find('footer') // Yield 'footer' within '.article'"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Incorrect Usage"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.find('.progress') // Errors, cannot be chained off 'cy'\ncy.clock().find('li') // Errors, 'clock' does not yield DOM elements"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Arguments"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "selector (String selector)"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "A selector used to match descendant DOM elements."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "options (Object)"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Pass in an options object to change the default behavior of `.find()`."
          }
        ]
      },
      {
        "type": "table",
        "align": [
          null,
          null,
          null
        ],
        "children": [
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Option"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Default"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Description"
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "`log`"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "`true`"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Displays the command in the "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/open-mode.md#Command-Log",
                    "children": [
                      {
                        "type": "text",
                        "value": "Command log"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "`timeout`"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/references/configuration.md#Timeouts",
                    "children": [
                      {
                        "type": "text",
                        "value": "`defaultCommandTimeout`"
                      }
                    ]
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Time to wait for `.find()` to resolve before "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "#Timeouts",
                    "children": [
                      {
                        "type": "text",
                        "value": "timing out"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "`includeShadowDom`"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/references/configuration.md#Global",
                    "children": [
                      {
                        "type": "text",
                        "value": "`includeShadowDom` config option value"
                      }
                    ]
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Whether to also search inside the shadow roots of the subject and its descendants, including nested shadow roots."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Yields"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` yields the new DOM element(s) it found."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` is a query, and it is safe to chain further commands."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Examples"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Selector"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Find the `li` elements inside a parent with `.find()`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "index.html"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "<ul id=\"parent\">\n  <li class=\"first\"></li>\n  <li class=\"second\"></li>\n</ul>"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "spec.cy.js"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// yields [<li class=\"first\"></li>, <li class=\"second\"></li>]\ncy.get('#parent').find('li')"
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Find direct children with a leading `>` in `.find()`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Start the selector with `>` to match only direct children of the subject. The result is the same as "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/children.md",
            "children": [
              {
                "type": "text",
                "value": "`.children('li')`"
              }
            ]
          },
          {
            "type": "text",
            "value": "."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "index.html"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "<ul class=\"nav\">\n  <li>Home</li>\n  <li>\n    Docs\n    <ul>\n      <li>API</li>\n    </ul>\n  </li>\n</ul>"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "spec.cy.js"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// yields [<li>Home</li>, <li>Docs<ul>…</ul></li>]\ncy.get('.nav').find('> li')\n\n// yields all 3 li elements, including the nested one\ncy.get('.nav').find('li')"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Assertions"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Assert on the number of elements `.find()` yields"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "When `.find()` is chained off another query such as "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/get.md",
            "children": [
              {
                "type": "text",
                "value": "`cy.get()`"
              }
            ]
          },
          {
            "type": "text",
            "value": ", Cypress reruns the whole chain until the assertion passes, so the count stays current as the page updates."
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('[data-cy=cart]').find('[data-cy=cart-item]').should('have.length', 3)"
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Assert that `.find()` no longer finds an element"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Chain `.should('not.exist')` to wait for an element, such as a loading spinner, to leave the subject."
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('[data-cy=results]').find('.spinner').should('not.exist')"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Options"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Wait longer for slow content with `timeout`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Pass `timeout` to give `.find()` more time than "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/app/references/configuration.md#Timeouts",
            "children": [
              {
                "type": "text",
                "value": "`defaultCommandTimeout`"
              }
            ]
          },
          {
            "type": "text",
            "value": " to locate its elements."
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('[data-cy=report]').find('table', { timeout: 10000 })"
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Find elements inside a shadow root with `includeShadowDom`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "By default, `.find()` does not search inside shadow roots. Pass `includeShadowDom: true` to search them, or set the "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/app/references/configuration.md#Global",
            "children": [
              {
                "type": "text",
                "value": "`includeShadowDom` configuration option"
              }
            ]
          },
          {
            "type": "text",
            "value": " to search them in every query."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "index.html"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "<checkout-panel>\n  #shadow-root\n  <button>Checkout</button>\n</checkout-panel>"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "spec.cy.js"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// yields [<button>Checkout</button>]\ncy.get('checkout-panel').find('button', { includeShadowDom: true })"
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Notes"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "`.find()` only searches below the subject"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "`.find()` matches descendants of the subject, never the subject itself. An element that matches the selector is left out of the result when it is the subject. To search from the root of the page instead, use "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/get.md",
            "children": [
              {
                "type": "text",
                "value": "`cy.get()`"
              }
            ]
          },
          {
            "type": "text",
            "value": ", and see "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/get.md#Get-vs-Find",
            "children": [
              {
                "type": "text",
                "value": "how `cy.get()` and `.find()` differ"
              }
            ]
          },
          {
            "type": "text",
            "value": "."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "index.html"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "<div class=\"card\">\n  <div class=\"card\">Nested</div>\n</div>"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "spec.cy.js"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// yields [<div class=\"card\">Nested</div>], not the outer .card\ncy.get('.card').first().find('.card')"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Subjects with multiple elements"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "When the subject holds more than one element, `.find()` searches inside each one and yields a single set, in document order, with any duplicates removed."
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "index.html"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "<ul>\n  <li><a href=\"/home\">Home</a></li>\n  <li><a href=\"/docs\">Docs</a></li>\n</ul>"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "spec.cy.js"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// yields [<a href=\"/home\">Home</a>, <a href=\"/docs\">Docs</a>]\ncy.get('li').find('a')"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "`.find()` compared to `.within()`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Chain `.find()` when you run one query inside an element. "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/within.md",
            "children": [
              {
                "type": "text",
                "value": "`.within()`"
              }
            ]
          },
          {
            "type": "text",
            "value": " scopes every command in its callback to the subject, which reads better when you run several commands against the same region."
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "// Option 1: one query\ncy.get('[data-cy=login-form]').find('[data-cy=submit]').click()\n\n// Option 2: several commands in the same region\ncy.get('[data-cy=login-form]').within(() => {\n  cy.get('[data-cy=email]').type('user@example.com')\n  cy.get('[data-cy=password]').type('secret')\n  cy.get('[data-cy=submit]').click()\n})"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Reading a `.find()` timeout error"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "When `.find()` times out without finding its elements, the error names the selector and lists the queries that produced its subject. The chain shows whether the problem is the `.find()` selector or an earlier query that yielded a different element than you expected."
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('[data-cy=cart]').find('.total')"
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "Timed out retrying after 4000ms: Expected to find element: `.total`, but never found it. Queried from:\n\n  > cy.get([data-cy=cart])"
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Shadow DOM boundaries and `.find()`"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Without `includeShadowDom`, `.find()` stops at a shadow boundary: it searches the markup written inside a shadow host, not the host's shadow root. Chained off an element that is already inside a shadow root, it searches that shadow tree normally, with or without the option. To search one shadow root only, traverse into it with "
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/api/commands/shadow.md",
            "children": [
              {
                "type": "text",
                "value": "`.shadow()`"
              }
            ]
          },
          {
            "type": "text",
            "value": " first:"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('checkout-panel').shadow().find('button')"
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Rules"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Requirements"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` requires being chained off a command that yields DOM element(s) or a document."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Assertions"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` will automatically "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/retry-ability.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "retry"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": " until the element(s) "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/introduction-to-cypress.md#Implicit-Assertions",
                    "children": [
                      {
                        "type": "text",
                        "value": "exist in the DOM"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": "."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` will automatically "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/retry-ability.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "retry"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": " until all chained assertions have passed."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Timeouts"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` can time out waiting for the element(s) to "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/introduction-to-cypress.md#Implicit-Assertions",
                    "children": [
                      {
                        "type": "text",
                        "value": "exist in the DOM"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": "."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` can time out waiting for assertions you've added to pass."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Command Log"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Find the `li` elements within the nav"
          }
        ]
      },
      {
        "type": "code",
        "lang": null,
        "meta": null,
        "value": "cy.get('.left-nav>.nav').find('>li')"
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "The commands above display in the Command Log as:"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Clicking the `find` command in the Command Log outputs the selector, the element(s) it was applied to, the yielded elements, and the number of elements found to the console:"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "History"
          }
        ]
      },
      {
        "type": "table",
        "align": [
          null,
          null
        ],
        "children": [
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Version"
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Changes"
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/references/changelog.md#12-6-0",
                    "children": [
                      {
                        "type": "text",
                        "value": "12.6.0"
                      }
                    ]
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Overwrite `.find()` with "
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/api/cypress-api/custom-queries.md#Overwriting-Existing-Queries",
                    "children": [
                      {
                        "type": "text",
                        "value": "`Cypress.Commands.overwriteQuery()`"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": " rather than `Cypress.Commands.overwrite()`."
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/references/changelog.md#12-0-0",
                    "children": [
                      {
                        "type": "text",
                        "value": "12.0.0"
                      }
                    ]
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "`.find()` is now a query."
                  }
                ]
              }
            ]
          },
          {
            "type": "tableRow",
            "children": [
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/references/changelog.md#5-2-0",
                    "children": [
                      {
                        "type": "text",
                        "value": "5.2.0"
                      }
                    ]
                  }
                ]
              },
              {
                "type": "tableCell",
                "children": [
                  {
                    "type": "text",
                    "value": "Added `includeShadowDom` option."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "See also"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/api/commands/get.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "`cy.get()`"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/api/commands/children.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "`.children()`"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/api/commands/shadow.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "`.shadow()`"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/api/commands/within.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "`.within()`"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "link",
                    "title": null,
                    "url": "/llm/markdown/app/core-concepts/retry-ability.md",
                    "children": [
                      {
                        "type": "text",
                        "value": "Retry-ability"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "token_estimate": 1249
}