{
  "doc": {
    "id": "api/commands/check",
    "title": "cy.check()",
    "description": "Check checkbox(es) or radio(s) in Cypress.",
    "section": "api",
    "source_path": "/llm/markdown/api/commands/check.md",
    "version": "c4ad6f88c531de58221c73dd91a75af7138334b8",
    "updated_at": "2026-11-10T01:15:02.829Z",
    "headings": [
      {
        "id": "api/commands/check#check",
        "text": "check",
        "level": 1
      },
      {
        "id": "api/commands/check#syntax",
        "text": "Syntax",
        "level": 2
      },
      {
        "id": "api/commands/check#usage",
        "text": "Usage",
        "level": 3
      },
      {
        "id": "api/commands/check#arguments",
        "text": "Arguments",
        "level": 3
      },
      {
        "id": "api/commands/check#yields",
        "text": "Yields",
        "level": 3
      },
      {
        "id": "api/commands/check#examples",
        "text": "Examples",
        "level": 2
      },
      {
        "id": "api/commands/check#no-args",
        "text": "No Args",
        "level": 3
      },
      {
        "id": "api/commands/check#check-all-checkboxes",
        "text": "Check all checkboxes",
        "level": 4
      },
      {
        "id": "api/commands/check#check-each-radio-in-a-set",
        "text": "Check each radio in a set",
        "level": 4
      },
      {
        "id": "api/commands/check#check-the-element-with-id-of-saveusername",
        "text": "Check the element with id of 'saveUserName'",
        "level": 4
      },
      {
        "id": "api/commands/check#value",
        "text": "Value",
        "level": 3
      },
      {
        "id": "api/commands/check#select-the-radio-with-the-value-of-us",
        "text": "Select the radio with the value of 'US'",
        "level": 4
      },
      {
        "id": "api/commands/check#values",
        "text": "Values",
        "level": 3
      },
      {
        "id": "api/commands/check#check-the-checkboxes-with-the-values-subscribe-and-accept",
        "text": "Check the checkboxes with the values 'subscribe' and 'accept'",
        "level": 4
      },
      {
        "id": "api/commands/check#options",
        "text": "Options",
        "level": 3
      },
      {
        "id": "api/commands/check#check-an-invisible-checkbox",
        "text": "Check an invisible checkbox",
        "level": 4
      },
      {
        "id": "api/commands/check#find-checked-option",
        "text": "Find checked option",
        "level": 3
      },
      {
        "id": "api/commands/check#notes",
        "text": "Notes",
        "level": 2
      },
      {
        "id": "api/commands/check#actionability",
        "text": "Actionability",
        "level": 3
      },
      {
        "id": "api/commands/check#the-element-must-first-reach-actionability",
        "text": "The element must first reach actionability",
        "level": 4
      },
      {
        "id": "api/commands/check#value-matching",
        "text": "Value matching",
        "level": 3
      },
      {
        "id": "api/commands/check#a-value-argument-filters-the-subject",
        "text": "A value argument filters the subject",
        "level": 4
      },
      {
        "id": "api/commands/check#checked-state",
        "text": "Checked state",
        "level": 3
      },
      {
        "id": "api/commands/check#checking-an-element-that-is-already-checked-does-nothing",
        "text": "Checking an element that is already checked does nothing",
        "level": 4
      },
      {
        "id": "api/commands/check#rules",
        "text": "Rules",
        "level": 2
      },
      {
        "id": "api/commands/check#requirements",
        "text": "Requirements",
        "level": 3
      },
      {
        "id": "api/commands/check#assertions",
        "text": "Assertions",
        "level": 3
      },
      {
        "id": "api/commands/check#timeouts",
        "text": "Timeouts",
        "level": 3
      },
      {
        "id": "api/commands/check#command-log",
        "text": "Command Log",
        "level": 2
      },
      {
        "id": "api/commands/check#history",
        "text": "History",
        "level": 2
      },
      {
        "id": "api/commands/check#see-also",
        "text": "See also",
        "level": 2
      }
    ]
  },
  "chunks": [
    {
      "id": "api/commands/check#syntax",
      "doc_id": "api/commands/check",
      "heading": "Syntax",
      "heading_level": 2,
      "content_markdown": "## Syntax\n\n```\n.check()\n.check(value)\n.check(values)\n.check(options)\n.check(value, options)\n.check(values, options)\n```\n\n### Usage\n\n**Correct Usage**\n\n```\ncy.get('[type=\"checkbox\"]').check() // Check checkbox element\ncy.get('[type=\"radio\"]').first().check() // Check first radio element\n```\n\n**Incorrect Usage**\n\n```\ncy.check('[type=\"checkbox\"]') // Errors, cannot be chained off 'cy'\ncy.get('p:first').check() // Errors, '.get()' does not yield checkbox or radio\n```\n\n### Arguments\n\n**value _(String)_**\n\nValue of checkbox or radio that should be checked.\n\n**values _(Array)_**\n\nValues of checkboxes or radios that should be checked.\n\n**options _(Object)_**\n\nPass in an options object to change the default behavior of `.check()`.\n\n| Option | Default | Description |\n| --- | --- | --- |\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| `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| `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| `timeout` | [`defaultCommandTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `.check()` 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*   `.check()` yields the same subject it was given.\n*   Passing a `value` or `values` narrows the yielded subject to the matching elements.\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 `.check()`.\n",
      "section": "api",
      "anchors": [
        "syntax"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 340
    },
    {
      "id": "api/commands/check#usage",
      "doc_id": "api/commands/check",
      "heading": "Usage",
      "heading_level": 3,
      "content_markdown": "### Usage\n\n**Correct Usage**\n\n```\ncy.get('[type=\"checkbox\"]').check() // Check checkbox element\ncy.get('[type=\"radio\"]').first().check() // Check first radio element\n```\n\n**Incorrect Usage**\n\n```\ncy.check('[type=\"checkbox\"]') // Errors, cannot be chained off 'cy'\ncy.get('p:first').check() // Errors, '.get()' does not yield checkbox or radio\n```\n",
      "section": "api",
      "anchors": [
        "usage"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 52
    },
    {
      "id": "api/commands/check#arguments",
      "doc_id": "api/commands/check",
      "heading": "Arguments",
      "heading_level": 3,
      "content_markdown": "### Arguments\n\n**value _(String)_**\n\nValue of checkbox or radio that should be checked.\n\n**values _(Array)_**\n\nValues of checkboxes or radios that should be checked.\n\n**options _(Object)_**\n\nPass in an options object to change the default behavior of `.check()`.\n\n| Option | Default | Description |\n| --- | --- | --- |\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| `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| `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| `timeout` | [`defaultCommandTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `.check()` 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/check.json",
      "token_estimate": 219
    },
    {
      "id": "api/commands/check#yields",
      "doc_id": "api/commands/check",
      "heading": "Yields",
      "heading_level": 3,
      "content_markdown": "### Yields\n\n*   `.check()` yields the same subject it was given.\n*   Passing a `value` or `values` narrows the yielded subject to the matching elements.\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 `.check()`.\n",
      "section": "api",
      "anchors": [
        "yields"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 53
    },
    {
      "id": "api/commands/check#examples",
      "doc_id": "api/commands/check",
      "heading": "Examples",
      "heading_level": 2,
      "content_markdown": "## Examples\n\n### No Args\n\n#### Check all checkboxes\n\n```\ncy.get('[type=\"checkbox\"]').check()\n```\n\n#### Check each radio in a set\n\n`.check()` acts on the elements in the subject one at a time. Radios that share a `name` are mutually exclusive, so the last one checked is the one that stays checked.\n\n```\ncy.get('[type=\"radio\"]').check()\n```\n\n#### Check the element with id of 'saveUserName'\n\n```\ncy.get('#saveUserName').check()\n```\n\n### Value\n\n#### Select the radio with the value of 'US'\n\n```\n<form>\n  <input type=\"radio\" id=\"ca-country\" value=\"CA\" />\n  <label for=\"ca-country\">Canada</label>\n  <input type=\"radio\" id=\"us-country\" value=\"US\" />\n  <label for=\"us-country\">United States</label>\n</form>\n```\n\n```\ncy.get('[type=\"radio\"]').check('US')\n```\n\n### Values\n\n#### Check the checkboxes with the values 'subscribe' and 'accept'\n\n```\n<form>\n  <input type=\"checkbox\" id=\"subscribe\" value=\"subscribe\" />\n  <label for=\"subscribe\">Subscribe to newsletter?</label>\n  <input type=\"checkbox\" id=\"acceptTerms\" value=\"accept\" />\n  <label for=\"acceptTerms\">Accept terms and conditions.</label>\n</form>\n```\n\n```\ncy.get('form input').check(['subscribe', 'accept'])\n```\n\n### Options\n\n#### Check an invisible checkbox\n\nSetting `force` to `true` skips the [actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md) checks, so Cypress clicks the element without first requiring it to be visible, enabled, and unobstructed.\n\n```\ncy.get('.action-checkboxes')\n  .should('not.be.visible') // Passes\n  .check({ force: true })\n  .should('be.checked') // Passes\n```\n\n### Find checked option\n\nYou can get the currently checked option using jQuery's [:checked selector](https://api.jquery.com/checked-selector/).\n\n```\n<form id=\"pick-fruit\">\n  <input type=\"radio\" name=\"fruit\" value=\"orange\" id=\"orange\" />\n  <input type=\"radio\" name=\"fruit\" value=\"apple\" id=\"apple\" checked=\"checked\" />\n  <input type=\"radio\" name=\"fruit\" value=\"banana\" id=\"banana\" />\n</form>\n```\n\n```\ncy.get('#pick-fruit :checked').should('be.checked').and('have.value', 'apple')\n```\n",
      "section": "api",
      "anchors": [
        "examples"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 299
    },
    {
      "id": "api/commands/check#no-args",
      "doc_id": "api/commands/check",
      "heading": "No Args",
      "heading_level": 3,
      "content_markdown": "### No Args\n\n#### Check all checkboxes\n\n```\ncy.get('[type=\"checkbox\"]').check()\n```\n\n#### Check each radio in a set\n\n`.check()` acts on the elements in the subject one at a time. Radios that share a `name` are mutually exclusive, so the last one checked is the one that stays checked.\n\n```\ncy.get('[type=\"radio\"]').check()\n```\n\n#### Check the element with id of 'saveUserName'\n\n```\ncy.get('#saveUserName').check()\n```\n",
      "section": "api",
      "anchors": [
        "no-args"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 83
    },
    {
      "id": "api/commands/check#check-each-radio-in-a-set",
      "doc_id": "api/commands/check",
      "heading": "Check each radio in a set",
      "heading_level": 4,
      "content_markdown": "#### Check each radio in a set\n\n`.check()` acts on the elements in the subject one at a time. Radios that share a `name` are mutually exclusive, so the last one checked is the one that stays checked.\n\n```\ncy.get('[type=\"radio\"]').check()\n```\n",
      "section": "api",
      "anchors": [
        "check-each-radio-in-a-set"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 55
    },
    {
      "id": "api/commands/check#value",
      "doc_id": "api/commands/check",
      "heading": "Value",
      "heading_level": 3,
      "content_markdown": "### Value\n\n#### Select the radio with the value of 'US'\n\n```\n<form>\n  <input type=\"radio\" id=\"ca-country\" value=\"CA\" />\n  <label for=\"ca-country\">Canada</label>\n  <input type=\"radio\" id=\"us-country\" value=\"US\" />\n  <label for=\"us-country\">United States</label>\n</form>\n```\n\n```\ncy.get('[type=\"radio\"]').check('US')\n```\n",
      "section": "api",
      "anchors": [
        "value"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 44
    },
    {
      "id": "api/commands/check#select-the-radio-with-the-value-of-us",
      "doc_id": "api/commands/check",
      "heading": "Select the radio with the value of 'US'",
      "heading_level": 4,
      "content_markdown": "#### Select the radio with the value of 'US'\n\n```\n<form>\n  <input type=\"radio\" id=\"ca-country\" value=\"CA\" />\n  <label for=\"ca-country\">Canada</label>\n  <input type=\"radio\" id=\"us-country\" value=\"US\" />\n  <label for=\"us-country\">United States</label>\n</form>\n```\n\n```\ncy.get('[type=\"radio\"]').check('US')\n```\n",
      "section": "api",
      "anchors": [
        "select-the-radio-with-the-value-of-us"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 41
    },
    {
      "id": "api/commands/check#values",
      "doc_id": "api/commands/check",
      "heading": "Values",
      "heading_level": 3,
      "content_markdown": "### Values\n\n#### Check the checkboxes with the values 'subscribe' and 'accept'\n\n```\n<form>\n  <input type=\"checkbox\" id=\"subscribe\" value=\"subscribe\" />\n  <label for=\"subscribe\">Subscribe to newsletter?</label>\n  <input type=\"checkbox\" id=\"acceptTerms\" value=\"accept\" />\n  <label for=\"acceptTerms\">Accept terms and conditions.</label>\n</form>\n```\n\n```\ncy.get('form input').check(['subscribe', 'accept'])\n```\n",
      "section": "api",
      "anchors": [
        "values"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 53
    },
    {
      "id": "api/commands/check#check-the-checkboxes-with-the-values-subscribe-and-accept",
      "doc_id": "api/commands/check",
      "heading": "Check the checkboxes with the values 'subscribe' and 'accept'",
      "heading_level": 4,
      "content_markdown": "#### Check the checkboxes with the values 'subscribe' and 'accept'\n\n```\n<form>\n  <input type=\"checkbox\" id=\"subscribe\" value=\"subscribe\" />\n  <label for=\"subscribe\">Subscribe to newsletter?</label>\n  <input type=\"checkbox\" id=\"acceptTerms\" value=\"accept\" />\n  <label for=\"acceptTerms\">Accept terms and conditions.</label>\n</form>\n```\n\n```\ncy.get('form input').check(['subscribe', 'accept'])\n```\n",
      "section": "api",
      "anchors": [
        "check-the-checkboxes-with-the-values-subscribe-and-accept"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 51
    },
    {
      "id": "api/commands/check#options",
      "doc_id": "api/commands/check",
      "heading": "Options",
      "heading_level": 3,
      "content_markdown": "### Options\n\n#### Check an invisible checkbox\n\nSetting `force` to `true` skips the [actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md) checks, so Cypress clicks the element without first requiring it to be visible, enabled, and unobstructed.\n\n```\ncy.get('.action-checkboxes')\n  .should('not.be.visible') // Passes\n  .check({ force: true })\n  .should('be.checked') // Passes\n```\n",
      "section": "api",
      "anchors": [
        "options"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 57
    },
    {
      "id": "api/commands/check#check-an-invisible-checkbox",
      "doc_id": "api/commands/check",
      "heading": "Check an invisible checkbox",
      "heading_level": 4,
      "content_markdown": "#### Check an invisible checkbox\n\nSetting `force` to `true` skips the [actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md) checks, so Cypress clicks the element without first requiring it to be visible, enabled, and unobstructed.\n\n```\ncy.get('.action-checkboxes')\n  .should('not.be.visible') // Passes\n  .check({ force: true })\n  .should('be.checked') // Passes\n```\n",
      "section": "api",
      "anchors": [
        "check-an-invisible-checkbox"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 55
    },
    {
      "id": "api/commands/check#find-checked-option",
      "doc_id": "api/commands/check",
      "heading": "Find checked option",
      "heading_level": 3,
      "content_markdown": "### Find checked option\n\nYou can get the currently checked option using jQuery's [:checked selector](https://api.jquery.com/checked-selector/).\n\n```\n<form id=\"pick-fruit\">\n  <input type=\"radio\" name=\"fruit\" value=\"orange\" id=\"orange\" />\n  <input type=\"radio\" name=\"fruit\" value=\"apple\" id=\"apple\" checked=\"checked\" />\n  <input type=\"radio\" name=\"fruit\" value=\"banana\" id=\"banana\" />\n</form>\n```\n\n```\ncy.get('#pick-fruit :checked').should('be.checked').and('have.value', 'apple')\n```\n",
      "section": "api",
      "anchors": [
        "find-checked-option"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 59
    },
    {
      "id": "api/commands/check#notes",
      "doc_id": "api/commands/check",
      "heading": "Notes",
      "heading_level": 2,
      "content_markdown": "## Notes\n\n### Actionability\n\n#### The element must first reach actionability\n\n`.check()` is an \"action command\" that follows all the rules of [Actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n\n### Value matching\n\n#### A value argument filters the subject\n\n`.check()` compares each argument against the element's `value` and acts only on the elements that match, yielding that narrowed set. Elements that don't match are left untouched, and a value that matches nothing is dropped without an error.\n\n```\n// If no checkbox has the value 'purple', this checks and yields only 'blue'\ncy.get('[type=\"checkbox\"]').check(['blue', 'purple'])\n```\n\nA checkbox or radio with no `value` attribute reports a value of `on`, so passing `'on'` to such an element fails with an error rather than checking it.\n\n### Checked state\n\n#### Checking an element that is already checked does nothing\n\n`.check()` skips the click when the element is already checked, so no `change` event fires and the console output notes that no operation took place. The element still has to be visible unless you pass `force: true`.\n\nA checkbox in an [indeterminate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/indeterminate) state leaves that state when you check it, whether or not the click happens.\n",
      "section": "api",
      "anchors": [
        "notes"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 248
    },
    {
      "id": "api/commands/check#value-matching",
      "doc_id": "api/commands/check",
      "heading": "Value matching",
      "heading_level": 3,
      "content_markdown": "### Value matching\n\n#### A value argument filters the subject\n\n`.check()` compares each argument against the element's `value` and acts only on the elements that match, yielding that narrowed set. Elements that don't match are left untouched, and a value that matches nothing is dropped without an error.\n\n```\n// If no checkbox has the value 'purple', this checks and yields only 'blue'\ncy.get('[type=\"checkbox\"]').check(['blue', 'purple'])\n```\n\nA checkbox or radio with no `value` attribute reports a value of `on`, so passing `'on'` to such an element fails with an error rather than checking it.\n",
      "section": "api",
      "anchors": [
        "value-matching"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 125
    },
    {
      "id": "api/commands/check#a-value-argument-filters-the-subject",
      "doc_id": "api/commands/check",
      "heading": "A value argument filters the subject",
      "heading_level": 4,
      "content_markdown": "#### A value argument filters the subject\n\n`.check()` compares each argument against the element's `value` and acts only on the elements that match, yielding that narrowed set. Elements that don't match are left untouched, and a value that matches nothing is dropped without an error.\n\n```\n// If no checkbox has the value 'purple', this checks and yields only 'blue'\ncy.get('[type=\"checkbox\"]').check(['blue', 'purple'])\n```\n\nA checkbox or radio with no `value` attribute reports a value of `on`, so passing `'on'` to such an element fails with an error rather than checking it.\n",
      "section": "api",
      "anchors": [
        "a-value-argument-filters-the-subject"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 121
    },
    {
      "id": "api/commands/check#checked-state",
      "doc_id": "api/commands/check",
      "heading": "Checked state",
      "heading_level": 3,
      "content_markdown": "### Checked state\n\n#### Checking an element that is already checked does nothing\n\n`.check()` skips the click when the element is already checked, so no `change` event fires and the console output notes that no operation took place. The element still has to be visible unless you pass `force: true`.\n\nA checkbox in an [indeterminate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/indeterminate) state leaves that state when you check it, whether or not the click happens.\n",
      "section": "api",
      "anchors": [
        "checked-state"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 92
    },
    {
      "id": "api/commands/check#checking-an-element-that-is-already-checked-does-nothing",
      "doc_id": "api/commands/check",
      "heading": "Checking an element that is already checked does nothing",
      "heading_level": 4,
      "content_markdown": "#### Checking an element that is already checked does nothing\n\n`.check()` skips the click when the element is already checked, so no `change` event fires and the console output notes that no operation took place. The element still has to be visible unless you pass `force: true`.\n\nA checkbox in an [indeterminate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/indeterminate) state leaves that state when you check it, whether or not the click happens.\n",
      "section": "api",
      "anchors": [
        "checking-an-element-that-is-already-checked-does-nothing"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 88
    },
    {
      "id": "api/commands/check#rules",
      "doc_id": "api/commands/check",
      "heading": "Rules",
      "heading_level": 2,
      "content_markdown": "## Rules\n\n### Requirements\n\n*   `.check()` requires being chained off a command that yields DOM element(s).\n*   `.check()` requires the element to have type `checkbox` or `radio`.\n\n### Assertions\n\n*   `.check()` will automatically wait for the element to reach an [actionable state](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n*   `.check()` will automatically [retry](/llm/markdown/app/core-concepts/retry-ability.md) until all chained assertions have passed.\n\n### Timeouts\n\n*   `.check()` can time out waiting for the element to reach an [actionable state](/llm/markdown/app/core-concepts/interacting-with-elements.md).\n*   `.check()` can time out waiting for assertions you've added to pass.\n",
      "section": "api",
      "anchors": [
        "rules"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 108
    },
    {
      "id": "api/commands/check#command-log",
      "doc_id": "api/commands/check",
      "heading": "Command Log",
      "heading_level": 2,
      "content_markdown": "## Command Log\n\n**_check the element with name of 'emailUser'_**\n\n```\ncy.get('form').find('[name=\"emailUser\"]').check()\n```\n\nThe commands above will display in the Command Log as:\n\nWhen clicking on `check` within the command log, the console outputs the following:\n",
      "section": "api",
      "anchors": [
        "command-log"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 48
    },
    {
      "id": "api/commands/check#history",
      "doc_id": "api/commands/check",
      "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| [10.0.1](/llm/markdown/app/references/changelog.md#10-0-1) | `.check()` removes the `indeterminate` state from a checkbox |\n| [8.4.0](/llm/markdown/app/references/changelog.md#8-4-0) | Clearer error when a value is passed and the element has no `value` attribute |\n| [6.1.0](/llm/markdown/app/references/changelog.md#6-1-0) | Added option `scrollBehavior` |\n| [0.14.0](/llm/markdown/app/references/changelog.md#0-14-0) | `.check()` narrows the yielded subject to the elements matching the passed value |\n| [0.6.12](/llm/markdown/app/references/changelog.md#0-6-12) | Added option `force` |\n",
      "section": "api",
      "anchors": [
        "history"
      ],
      "path": "/llm/json/chunked/api/commands/check.json",
      "token_estimate": 124
    }
  ]
}