{ "doc": { "id": "api/commands/contains", "title": "contains | Cypress Documentation", "description": "Get the DOM element containing the text in Cypress.", "section": "api", "source_path": "/llm/markdown/api/commands/contains.md", "version": "e6988a974973e9090ce70406c38cb2b9e0eac9fa", "updated_at": "2026-05-15T15:50:22.536Z", "headings": [ { "id": "api/commands/contains#contains", "text": "contains", "level": 1 }, { "id": "api/commands/contains#syntax", "text": "Syntax", "level": 2 }, { "id": "api/commands/contains#usage", "text": "Usage", "level": 3 }, { "id": "api/commands/contains#arguments", "text": "Arguments", "level": 3 }, { "id": "api/commands/contains#yields-learn-about-subject-management", "text": "Yields Learn about subject management", "level": 3 }, { "id": "api/commands/contains#examples", "text": "Examples", "level": 2 }, { "id": "api/commands/contains#content", "text": "Content", "level": 3 }, { "id": "api/commands/contains#find-the-first-element-containing-some-text", "text": "Find the first element containing some text", "level": 4 }, { "id": "api/commands/contains#find-the-input-type-submit-by-value", "text": "Find the input[type='submit'] by value", "level": 4 }, { "id": "api/commands/contains#number", "text": "Number", "level": 3 }, { "id": "api/commands/contains#find-the-first-element-containing-a-number", "text": "Find the first element containing a number", "level": 4 }, { "id": "api/commands/contains#regular-expression", "text": "Regular Expression", "level": 3 }, { "id": "api/commands/contains#find-the-first-element-with-text-matching-the-regular-expression", "text": "Find the first element with text matching the regular expression", "level": 4 }, { "id": "api/commands/contains#selector", "text": "Selector", "level": 3 }, { "id": "api/commands/contains#specify-a-selector-to-return-a-specific-element", "text": "Specify a selector to return a specific element", "level": 4 }, { "id": "api/commands/contains#keep-the-form-as-the-subject", "text": "Keep the form as the subject", "level": 4 }, { "id": "api/commands/contains#case-sensitivity", "text": "Case Sensitivity", "level": 3 }, { "id": "api/commands/contains#notes", "text": "Notes", "level": 2 }, { "id": "api/commands/contains#scopes", "text": "Scopes", "level": 3 }, { "id": "api/commands/contains#when-starting-a-series-of-commands", "text": "When starting a series of commands:", "level": 4 }, { "id": "api/commands/contains#when-chained-to-an-existing-series-of-commands", "text": "When chained to an existing series of commands", "level": 4 }, { "id": "api/commands/contains#be-wary-of-chaining-multiple-contains", "text": "Be wary of chaining multiple contains", "level": 4 }, { "id": "api/commands/contains#leading-trailing-duplicate-whitespaces-arent-ignored-in-pre-tag", "text": "Leading, trailing, duplicate whitespaces aren't ignored in 
 tag",
        "level": 3
      },
      {
        "id": "api/commands/contains#non-breaking-space",
        "text": "Non-breaking space",
        "level": 3
      },
      {
        "id": "api/commands/contains#single-element",
        "text": "Single Element",
        "level": 3
      },
      {
        "id": "api/commands/contains#only-the-first-matched-element-will-be-returned",
        "text": "Only the first matched element will be returned",
        "level": 4
      },
      {
        "id": "api/commands/contains#default-input-type-submit-labels",
        "text": "Default  labels",
        "level": 3
      },
      {
        "id": "api/commands/contains#preferences",
        "text": "Preferences",
        "level": 3
      },
      {
        "id": "api/commands/contains#element-preference-order",
        "text": "Element preference order",
        "level": 4
      },
      {
        "id": "api/commands/contains#favor-of-button-over-other-deeper-elements",
        "text": "Favor of \n```\n\n```\n// yields \n```\n\n```\ncy.get('form') // yields 
...
  .contains('form', 'Proceed') // yields 
...
  .submit() // yields 
...
\n```\n\nWithout the explicit selector the subject would change to be the `\n```\n\n```\n// yields \n```\n\n```\n// yields \n```\n\n```\ncy.get('form') // yields 
...
  .contains('form', 'Proceed') // yields 
...
  .submit() // yields 
...
\n```\n\nWithout the explicit selector the subject would change to be the `\n```\n\n```\ncy.get('form') // yields 
...
  .contains('form', 'Proceed') // yields 
...
  .submit() // yields 
...
\n```\n\nWithout the explicit selector the subject would change to be the `\n```\n\n```\n// yields \n```\n\n```\n// yields \n```\n\n```\n// yields