{
  "doc": {
    "id": "api/commands/click",
    "title": "cy.click()",
    "description": "Click a DOM element in Cypress.",
    "section": "api",
    "source_path": "/llm/markdown/api/commands/click.md",
    "version": "e6c8d867c21227247f14714fb5690c7c018983c5",
    "updated_at": "2026-08-08T12:39:37.868Z",
    "headings": [
      {
        "id": "api/commands/click#click",
        "text": "click",
        "level": 1
      },
      {
        "id": "api/commands/click#syntax",
        "text": "Syntax",
        "level": 2
      },
      {
        "id": "api/commands/click#usage",
        "text": "Usage",
        "level": 3
      },
      {
        "id": "api/commands/click#arguments",
        "text": "Arguments",
        "level": 3
      },
      {
        "id": "api/commands/click#yields",
        "text": "Yields",
        "level": 3
      },
      {
        "id": "api/commands/click#examples",
        "text": "Examples",
        "level": 2
      },
      {
        "id": "api/commands/click#no-args",
        "text": "No Args",
        "level": 3
      },
      {
        "id": "api/commands/click#click-a-link-in-a-nav",
        "text": "Click a link in a nav",
        "level": 4
      },
      {
        "id": "api/commands/click#position",
        "text": "Position",
        "level": 3
      },
      {
        "id": "api/commands/click#specify-a-corner-of-the-element-to-click",
        "text": "Specify a corner of the element to click",
        "level": 4
      },
      {
        "id": "api/commands/click#coordinates",
        "text": "Coordinates",
        "level": 3
      },
      {
        "id": "api/commands/click#specify-explicit-coordinates-relative-to-the-top-left-corner",
        "text": "Specify explicit coordinates relative to the top left corner",
        "level": 4
      },
      {
        "id": "api/commands/click#options",
        "text": "Options",
        "level": 3
      },
      {
        "id": "api/commands/click#force-a-click-regardless-of-its-actionable-state",
        "text": "Force a click regardless of its actionable state",
        "level": 4
      },
      {
        "id": "api/commands/click#force-a-click-with-position-argument",
        "text": "Force a click with position argument",
        "level": 4
      },
      {
        "id": "api/commands/click#force-a-click-with-relative-coordinates",
        "text": "Force a click with relative coordinates",
        "level": 4
      },
      {
        "id": "api/commands/click#click-all-elements-with-id-starting-with-btn",
        "text": "Click all elements with id starting with 'btn'",
        "level": 4
      },
      {
        "id": "api/commands/click#click-with-key-combinations",
        "text": "Click with key combinations",
        "level": 4
      },
      {
        "id": "api/commands/click#shift-click",
        "text": "Shift click",
        "level": 4
      },
      {
        "id": "api/commands/click#notes",
        "text": "Notes",
        "level": 2
      },
      {
        "id": "api/commands/click#actionability",
        "text": "Actionability",
        "level": 3
      },
      {
        "id": "api/commands/click#the-element-must-first-reach-actionability",
        "text": "The element must first reach actionability",
        "level": 4
      },
      {
        "id": "api/commands/click#focus",
        "text": "Focus",
        "level": 3
      },
      {
        "id": "api/commands/click#focus-is-given-to-the-first-focusable-element",
        "text": "Focus is given to the first focusable element",
        "level": 4
      },
      {
        "id": "api/commands/click#cancellation",
        "text": "Cancellation",
        "level": 3
      },
      {
        "id": "api/commands/click#mousedown-cancellation-will-not-cause-focus",
        "text": "Mousedown cancellation will not cause focus",
        "level": 4
      },
      {
        "id": "api/commands/click#rules",
        "text": "Rules",
        "level": 2
      },
      {
        "id": "api/commands/click#requirements",
        "text": "Requirements",
        "level": 3
      },
      {
        "id": "api/commands/click#assertions",
        "text": "Assertions",
        "level": 3
      },
      {
        "id": "api/commands/click#timeouts",
        "text": "Timeouts",
        "level": 3
      },
      {
        "id": "api/commands/click#command-log",
        "text": "Command Log",
        "level": 2
      },
      {
        "id": "api/commands/click#history",
        "text": "History",
        "level": 2
      },
      {
        "id": "api/commands/click#see-also",
        "text": "See also",
        "level": 2
      }
    ]
  },
  "chunks": [
    {
      "id": "api/commands/click#syntax",
      "doc_id": "api/commands/click",
      "heading": "Syntax",
      "heading_level": 2,
      "content_markdown": "## Syntax\n\n```\n.click().click(options).click(position).click(position, options).click(x, y).click(x, y, options)\n```\n\n### Usage\n\n**Correct Usage**\n\n```\ncy.get('.btn').click() // Click on buttoncy.focused().click() // Click on el with focuscy.contains('Welcome').click() // Click on first el containing 'Welcome'\n```\n\n**Incorrect Usage**\n\n```\ncy.click('.btn') // Errors, cannot be chained off 'cy'cy.window().click() // Errors, 'window' does not yield DOM element\n```\n\n### Arguments\n\n**position _(String)_**\n\nThe position where the click should be issued. The `center` position is the default position. Valid positions are `topLeft`, `top`, `topRight`, `left`, `center`, `right`, `bottomLeft`, `bottom`, and `bottomRight`.\n\n**x _(Number)_**\n\nThe distance in pixels from the element's left to issue the click.\n\n**y _(Number)_**\n\nThe distance in pixels from the element's top to issue the click.\n\n**options _(Object)_**\n\nPass in an options object to change the default behavior of `.click()`.\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `altKey` | `false` | Activates the alt key (option key for Mac). Aliases: `optionKey`. |\n| `animationDistanceThreshold` | [`animationDistanceThreshold`](/llm/markdown/app/references/configuration.md#Actionability) | The distance in pixels an element must exceed over time to be [considered animating](/llm/markdown/app/core-concepts/interacting-with-elements.md#Animations). |\n| `ctrlKey` | `false` | Activates the control key. Aliases: `controlKey`. |\n| `log` | `true` | Displays the command in the [Command log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) |\n| `force` | `false` | Forces the action, disables [waiting for actionability](#Assertions) |\n| `metaKey` | `false` | Activates the meta key (Windows key or command key for Mac). Aliases: `commandKey`, `cmdKey`. |\n| `multiple` | `false` | Serially click multiple elements |\n| `scrollBehavior` | [`scrollBehavior`](/llm/markdown/app/references/configuration.md#Actionability) | Viewport position to where an element [should be scrolled](/llm/markdown/app/core-concepts/interacting-with-elements.md#Scrolling) before executing the command. Accepts a single alignment, a per-axis `{ block, inline }` object, or `false`. |\n| `shiftKey` | `false` | Activates the shift key. |\n| `timeout` | [`defaultCommandTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `.click()` to resolve before [timing out](#Timeouts) |\n| `waitForAnimations` | [`waitForAnimations`](/llm/markdown/app/references/configuration.md#Actionability) | Whether to wait for elements to [finish animating](/llm/markdown/app/core-concepts/interacting-with-elements.md#Animations) before executing the command. |\n\n### Yields\n\n*   `.click()` yields the same subject it was given.\n*   It is [unsafe](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried) to chain further commands that rely on the subject after `.click()`.\n",
      "section": "api",
      "anchors": [
        "syntax"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 463
    },
    {
      "id": "api/commands/click#usage",
      "doc_id": "api/commands/click",
      "heading": "Usage",
      "heading_level": 3,
      "content_markdown": "### Usage\n\n**Correct Usage**\n\n```\ncy.get('.btn').click() // Click on buttoncy.focused().click() // Click on el with focuscy.contains('Welcome').click() // Click on first el containing 'Welcome'\n```\n\n**Incorrect Usage**\n\n```\ncy.click('.btn') // Errors, cannot be chained off 'cy'cy.window().click() // Errors, 'window' does not yield DOM element\n```\n",
      "section": "api",
      "anchors": [
        "usage"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 59
    },
    {
      "id": "api/commands/click#arguments",
      "doc_id": "api/commands/click",
      "heading": "Arguments",
      "heading_level": 3,
      "content_markdown": "### Arguments\n\n**position _(String)_**\n\nThe position where the click should be issued. The `center` position is the default position. Valid positions are `topLeft`, `top`, `topRight`, `left`, `center`, `right`, `bottomLeft`, `bottom`, and `bottomRight`.\n\n**x _(Number)_**\n\nThe distance in pixels from the element's left to issue the click.\n\n**y _(Number)_**\n\nThe distance in pixels from the element's top to issue the click.\n\n**options _(Object)_**\n\nPass in an options object to change the default behavior of `.click()`.\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `altKey` | `false` | Activates the alt key (option key for Mac). Aliases: `optionKey`. |\n| `animationDistanceThreshold` | [`animationDistanceThreshold`](/llm/markdown/app/references/configuration.md#Actionability) | The distance in pixels an element must exceed over time to be [considered animating](/llm/markdown/app/core-concepts/interacting-with-elements.md#Animations). |\n| `ctrlKey` | `false` | Activates the control key. Aliases: `controlKey`. |\n| `log` | `true` | Displays the command in the [Command log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) |\n| `force` | `false` | Forces the action, disables [waiting for actionability](#Assertions) |\n| `metaKey` | `false` | Activates the meta key (Windows key or command key for Mac). Aliases: `commandKey`, `cmdKey`. |\n| `multiple` | `false` | Serially click multiple elements |\n| `scrollBehavior` | [`scrollBehavior`](/llm/markdown/app/references/configuration.md#Actionability) | Viewport position to where an element [should be scrolled](/llm/markdown/app/core-concepts/interacting-with-elements.md#Scrolling) before executing the command. Accepts a single alignment, a per-axis `{ block, inline }` object, or `false`. |\n| `shiftKey` | `false` | Activates the shift key. |\n| `timeout` | [`defaultCommandTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `.click()` to resolve before [timing out](#Timeouts) |\n| `waitForAnimations` | [`waitForAnimations`](/llm/markdown/app/references/configuration.md#Actionability) | Whether to wait for elements to [finish animating](/llm/markdown/app/core-concepts/interacting-with-elements.md#Animations) before executing the command. |\n",
      "section": "api",
      "anchors": [
        "arguments"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 357
    },
    {
      "id": "api/commands/click#examples",
      "doc_id": "api/commands/click",
      "heading": "Examples",
      "heading_level": 2,
      "content_markdown": "## Examples\n\n### No Args\n\n#### Click a link in a nav\n\n```\ncy.get('.nav > a').click()\n```\n\n### Position\n\n#### Specify a corner of the element to click\n\nClick the top right corner of the button.\n\n```\ncy.get('img').click('topRight')\n```\n\n### Coordinates\n\n#### Specify explicit coordinates relative to the top left corner\n\nThe click below will be issued inside of the element (15px from the left and 40px from the top).\n\n```\ncy.get('#top-banner').click(15, 40)\n```\n\n### Options\n\n#### Force a click regardless of its actionable state\n\nForcing a click overrides the [actionable checks](/llm/markdown/app/core-concepts/interacting-with-elements.md#Forcing) Cypress applies and will automatically fire the events.\n\n```\ncy.get('.close').as('closeBtn')cy.get('@closeBtn').click({ force: true })\n```\n\n#### Force a click with position argument\n\n```\ncy.get('#collapse-sidebar').click('bottomLeft', { force: true })\n```\n\n#### Force a click with relative coordinates\n\n```\ncy.get('#footer .next').click(5, 60, { force: true })\n```\n\n#### Click all elements with id starting with 'btn'\n\nBy default, Cypress will error if you're trying to click multiple elements. By passing `{ multiple: true }` Cypress will iteratively apply the click to each element and will also log to the [Command Log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) multiple times.\n\n```\ncy.get('[id^=btn]').click({ multiple: true })\n```\n\n#### Click with key combinations\n\nThe `.click()` command may also be fired with key modifiers in order to simulate holding key combinations while clicking, such as `ALT + click`.\n\nYou can also use key combinations during [.type()](/llm/markdown/api/commands/type.md). This offers options to hold down keys across multiple commands. See [Key Combinations](/llm/markdown/api/commands/type.md#Key-Combinations) for more information.\n\nThe following keys can be combined with `.click()` through the `options`.\n\n| Option | Notes |\n| --- | --- |\n| `altKey` | Activates the alt key (option key for Mac). Aliases: `optionKey`. |\n| `ctrlKey` | Activates the control key. Aliases: `controlKey`. |\n| `metaKey` | Activates the meta key (Windows key or command key for Mac). Aliases: `commandKey`, `cmdKey`. |\n| `shiftKey` | Activates the shift key. |\n\n#### Shift click\n\n```\n// execute a SHIFT + click on the first <li>cy.get('li:first').click({  shiftKey: true,})\n```\n",
      "section": "api",
      "anchors": [
        "examples"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 439
    },
    {
      "id": "api/commands/click#coordinates",
      "doc_id": "api/commands/click",
      "heading": "Coordinates",
      "heading_level": 3,
      "content_markdown": "### Coordinates\n\n#### Specify explicit coordinates relative to the top left corner\n\nThe click below will be issued inside of the element (15px from the left and 40px from the top).\n\n```\ncy.get('#top-banner').click(15, 40)\n```\n",
      "section": "api",
      "anchors": [
        "coordinates"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 47
    },
    {
      "id": "api/commands/click#specify-explicit-coordinates-relative-to-the-top-left-corner",
      "doc_id": "api/commands/click",
      "heading": "Specify explicit coordinates relative to the top left corner",
      "heading_level": 4,
      "content_markdown": "#### Specify explicit coordinates relative to the top left corner\n\nThe click below will be issued inside of the element (15px from the left and 40px from the top).\n\n```\ncy.get('#top-banner').click(15, 40)\n```\n",
      "section": "api",
      "anchors": [
        "specify-explicit-coordinates-relative-to-the-top-left-corner"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 44
    },
    {
      "id": "api/commands/click#options",
      "doc_id": "api/commands/click",
      "heading": "Options",
      "heading_level": 3,
      "content_markdown": "### Options\n\n#### Force a click regardless of its actionable state\n\nForcing a click overrides the [actionable checks](/llm/markdown/app/core-concepts/interacting-with-elements.md#Forcing) Cypress applies and will automatically fire the events.\n\n```\ncy.get('.close').as('closeBtn')cy.get('@closeBtn').click({ force: true })\n```\n\n#### Force a click with position argument\n\n```\ncy.get('#collapse-sidebar').click('bottomLeft', { force: true })\n```\n\n#### Force a click with relative coordinates\n\n```\ncy.get('#footer .next').click(5, 60, { force: true })\n```\n\n#### Click all elements with id starting with 'btn'\n\nBy default, Cypress will error if you're trying to click multiple elements. By passing `{ multiple: true }` Cypress will iteratively apply the click to each element and will also log to the [Command Log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) multiple times.\n\n```\ncy.get('[id^=btn]').click({ multiple: true })\n```\n\n#### Click with key combinations\n\nThe `.click()` command may also be fired with key modifiers in order to simulate holding key combinations while clicking, such as `ALT + click`.\n\nYou can also use key combinations during [.type()](/llm/markdown/api/commands/type.md). This offers options to hold down keys across multiple commands. See [Key Combinations](/llm/markdown/api/commands/type.md#Key-Combinations) for more information.\n\nThe following keys can be combined with `.click()` through the `options`.\n\n| Option | Notes |\n| --- | --- |\n| `altKey` | Activates the alt key (option key for Mac). Aliases: `optionKey`. |\n| `ctrlKey` | Activates the control key. Aliases: `controlKey`. |\n| `metaKey` | Activates the meta key (Windows key or command key for Mac). Aliases: `commandKey`, `cmdKey`. |\n| `shiftKey` | Activates the shift key. |\n\n#### Shift click\n\n```\n// execute a SHIFT + click on the first <li>cy.get('li:first').click({  shiftKey: true,})\n```\n",
      "section": "api",
      "anchors": [
        "options"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 340
    },
    {
      "id": "api/commands/click#force-a-click-regardless-of-its-actionable-state",
      "doc_id": "api/commands/click",
      "heading": "Force a click regardless of its actionable state",
      "heading_level": 4,
      "content_markdown": "#### Force a click regardless of its actionable state\n\nForcing a click overrides the [actionable checks](/llm/markdown/app/core-concepts/interacting-with-elements.md#Forcing) Cypress applies and will automatically fire the events.\n\n```\ncy.get('.close').as('closeBtn')cy.get('@closeBtn').click({ force: true })\n```\n",
      "section": "api",
      "anchors": [
        "force-a-click-regardless-of-its-actionable-state"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 40
    },
    {
      "id": "api/commands/click#click-all-elements-with-id-starting-with-btn",
      "doc_id": "api/commands/click",
      "heading": "Click all elements with id starting with 'btn'",
      "heading_level": 4,
      "content_markdown": "#### Click all elements with id starting with 'btn'\n\nBy default, Cypress will error if you're trying to click multiple elements. By passing `{ multiple: true }` Cypress will iteratively apply the click to each element and will also log to the [Command Log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) multiple times.\n\n```\ncy.get('[id^=btn]').click({ multiple: true })\n```\n",
      "section": "api",
      "anchors": [
        "click-all-elements-with-id-starting-with-btn"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 69
    },
    {
      "id": "api/commands/click#click-with-key-combinations",
      "doc_id": "api/commands/click",
      "heading": "Click with key combinations",
      "heading_level": 4,
      "content_markdown": "#### Click with key combinations\n\nThe `.click()` command may also be fired with key modifiers in order to simulate holding key combinations while clicking, such as `ALT + click`.\n\nYou can also use key combinations during [.type()](/llm/markdown/api/commands/type.md). This offers options to hold down keys across multiple commands. See [Key Combinations](/llm/markdown/api/commands/type.md#Key-Combinations) for more information.\n\nThe following keys can be combined with `.click()` through the `options`.\n\n| Option | Notes |\n| --- | --- |\n| `altKey` | Activates the alt key (option key for Mac). Aliases: `optionKey`. |\n| `ctrlKey` | Activates the control key. Aliases: `controlKey`. |\n| `metaKey` | Activates the meta key (Windows key or command key for Mac). Aliases: `commandKey`, `cmdKey`. |\n| `shiftKey` | Activates the shift key. |\n",
      "section": "api",
      "anchors": [
        "click-with-key-combinations"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 165
    },
    {
      "id": "api/commands/click#notes",
      "doc_id": "api/commands/click",
      "heading": "Notes",
      "heading_level": 2,
      "content_markdown": "## Notes\n\n### Actionability\n\n#### The element must first reach actionability\n\n`.click()` is an \"action command\" that follows all the rules of [Actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n\n### Focus\n\n#### Focus is given to the first focusable element\n\nFor example, clicking a `<span>` inside of a `<button>` gives the focus to the button, since that's what would happen in a real user scenario.\n\nHowever, Cypress additionally handles situations where a child descendent is clicked inside of a focusable parent, but actually isn't visually inside the parent (per the CSS Object Model). In those cases if no focusable parent is found the window is given focus instead (which matches real browser behavior).\n\n### Cancellation\n\n#### Mousedown cancellation will not cause focus\n\nIf the mousedown event has its default action prevented ( `e.preventDefault()` ) then the element will not receive focus as per the spec.\n",
      "section": "api",
      "anchors": [
        "notes"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 185
    },
    {
      "id": "api/commands/click#focus",
      "doc_id": "api/commands/click",
      "heading": "Focus",
      "heading_level": 3,
      "content_markdown": "### Focus\n\n#### Focus is given to the first focusable element\n\nFor example, clicking a `<span>` inside of a `<button>` gives the focus to the button, since that's what would happen in a real user scenario.\n\nHowever, Cypress additionally handles situations where a child descendent is clicked inside of a focusable parent, but actually isn't visually inside the parent (per the CSS Object Model). In those cases if no focusable parent is found the window is given focus instead (which matches real browser behavior).\n",
      "section": "api",
      "anchors": [
        "focus"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 112
    },
    {
      "id": "api/commands/click#focus-is-given-to-the-first-focusable-element",
      "doc_id": "api/commands/click",
      "heading": "Focus is given to the first focusable element",
      "heading_level": 4,
      "content_markdown": "#### Focus is given to the first focusable element\n\nFor example, clicking a `<span>` inside of a `<button>` gives the focus to the button, since that's what would happen in a real user scenario.\n\nHowever, Cypress additionally handles situations where a child descendent is clicked inside of a focusable parent, but actually isn't visually inside the parent (per the CSS Object Model). In those cases if no focusable parent is found the window is given focus instead (which matches real browser behavior).\n",
      "section": "api",
      "anchors": [
        "focus-is-given-to-the-first-focusable-element"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 109
    },
    {
      "id": "api/commands/click#cancellation",
      "doc_id": "api/commands/click",
      "heading": "Cancellation",
      "heading_level": 3,
      "content_markdown": "### Cancellation\n\n#### Mousedown cancellation will not cause focus\n\nIf the mousedown event has its default action prevented ( `e.preventDefault()` ) then the element will not receive focus as per the spec.\n",
      "section": "api",
      "anchors": [
        "cancellation"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 43
    },
    {
      "id": "api/commands/click#mousedown-cancellation-will-not-cause-focus",
      "doc_id": "api/commands/click",
      "heading": "Mousedown cancellation will not cause focus",
      "heading_level": 4,
      "content_markdown": "#### Mousedown cancellation will not cause focus\n\nIf the mousedown event has its default action prevented ( `e.preventDefault()` ) then the element will not receive focus as per the spec.\n",
      "section": "api",
      "anchors": [
        "mousedown-cancellation-will-not-cause-focus"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 40
    },
    {
      "id": "api/commands/click#rules",
      "doc_id": "api/commands/click",
      "heading": "Rules",
      "heading_level": 2,
      "content_markdown": "## Rules\n\n### Requirements\n\n*   `.click()` requires being chained off a command that yields DOM element(s).\n\n### Assertions\n\n*   `.click()` will automatically wait for the element to reach an [actionable state](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n*   `.click()` itself will not be retried — it fires once when the element is actionable. Assertions chained after `.click()` will be retried until they pass or time out. See [Only queries are retried](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried).\n\n### Timeouts\n\n*   `.click()` can time out waiting for the element to reach an [actionable state](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n*   `.click()` can time out waiting for assertions you've added to pass.\n",
      "section": "api",
      "anchors": [
        "rules"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 124
    },
    {
      "id": "api/commands/click#assertions",
      "doc_id": "api/commands/click",
      "heading": "Assertions",
      "heading_level": 3,
      "content_markdown": "### Assertions\n\n*   `.click()` will automatically wait for the element to reach an [actionable state](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n*   `.click()` itself will not be retried — it fires once when the element is actionable. Assertions chained after `.click()` will be retried until they pass or time out. See [Only queries are retried](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried).\n",
      "section": "api",
      "anchors": [
        "assertions"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 65
    },
    {
      "id": "api/commands/click#command-log",
      "doc_id": "api/commands/click",
      "heading": "Command Log",
      "heading_level": 2,
      "content_markdown": "## Command Log\n\n**_Click the button_**\n\n```\ncy.get('.action-btn').click()\n```\n\nThe commands above will display in the Command Log as:\n\nWhen clicking on `click` within the command log, the console outputs the following:\n",
      "section": "api",
      "anchors": [
        "command-log"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 43
    },
    {
      "id": "api/commands/click#history",
      "doc_id": "api/commands/click",
      "heading": "History",
      "heading_level": 2,
      "content_markdown": "## History\n\n| Version | Changes |\n| --- | --- |\n| [15.20.0](/llm/markdown/app/references/changelog.md#15-20-0) | Option `scrollBehavior` now accepts a per-axis `{ block, inline }` object and the `'start'` and `'end'` alignments |\n| [6.1.0](/llm/markdown/app/references/changelog.md#6-1-0) | Added option `scrollBehavior` |\n| [3.5.0](/llm/markdown/app/references/changelog.md#3-5-0) | Added sending `mouseover`, `mousemove`, `mouseout`, `pointerdown`, `pointerup`, and `pointermove` during `.click()` |\n",
      "section": "api",
      "anchors": [
        "history"
      ],
      "path": "/llm/json/chunked/api/commands/click.json",
      "token_estimate": 73
    }
  ]
}