{ "doc": { "id": "api/commands/root", "title": "root | Cypress Documentation", "description": "Get the root DOM element in Cypress.", "section": "api", "source_path": "/llm/markdown/api/commands/root.md", "version": "204dffbf7fbb64b1fe8343a54ddcd869cc275f1f", "updated_at": "2026-05-12T20:33:17.938Z", "headings": [ { "id": "api/commands/root#root", "text": "root", "level": 1 }, { "id": "api/commands/root#syntax", "text": "Syntax", "level": 2 }, { "id": "api/commands/root#usage", "text": "Usage", "level": 3 }, { "id": "api/commands/root#arguments", "text": "Arguments", "level": 3 }, { "id": "api/commands/root#yields-learn-about-subject-management", "text": "Yields Learn about subject management", "level": 3 }, { "id": "api/commands/root#examples", "text": "Examples", "level": 2 }, { "id": "api/commands/root#html", "text": "HTML", "level": 3 }, { "id": "api/commands/root#get-the-root-element", "text": "Get the root element", "level": 4 }, { "id": "api/commands/root#within", "text": "Within", "level": 3 }, { "id": "api/commands/root#get-the-root-element-in-a-within-callback-function", "text": "Get the root element in a .within() callback function", "level": 4 }, { "id": "api/commands/root#rules", "text": "Rules", "level": 2 }, { "id": "api/commands/root#requirements-learn-about-chaining-commands", "text": "Requirements Learn about chaining commands", "level": 3 }, { "id": "api/commands/root#assertions-learn-about-assertions", "text": "Assertions Learn about assertions", "level": 3 }, { "id": "api/commands/root#timeouts-learn-about-timeouts", "text": "Timeouts Learn about timeouts", "level": 3 }, { "id": "api/commands/root#command-log", "text": "Command Log", "level": 2 }, { "id": "api/commands/root#see-also", "text": "See also", "level": 2 } ] }, "content": { "type": "root", "children": [ { "type": "heading", "depth": 1, "children": [ { "type": "text", "value": "root" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Get the root DOM element." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Syntax" } ] }, { "type": "code", "lang": null, "meta": null, "value": "cy.root()cy.root(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.root() // Yield root element cy.get('nav').within(($nav) => { cy.root() // Yield root element