From 2bac10ed10bfe30d96150cd71358b0ceb32f2399 Mon Sep 17 00:00:00 2001
From: Jennifer Shehane <shehane.jennifer@gmail.com>
Date: Fri, 16 May 2025 10:43:39 -0400
Subject: [PATCH 1/5] update examples to have them follow unsafe to chain
 conventions

---
 docs/api/commands/blur.mdx  | 3 ++-
 docs/api/commands/focus.mdx | 5 +++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/api/commands/blur.mdx b/docs/api/commands/blur.mdx
index 36c264f26f..2d550184f9 100644
--- a/docs/api/commands/blur.mdx
+++ b/docs/api/commands/blur.mdx
@@ -74,7 +74,8 @@ Pass in an options object to change the default behavior of `.blur`.
 #### Blur the comment input
 
 ```javascript
-cy.get('[name="comment"]').type('Nice Product!').blur()
+cy.get('[name="comment"]').type('Nice Product!')
+cy.get('[name="comment"]').blur()
 ```
 
 ### Options
diff --git a/docs/api/commands/focus.mdx b/docs/api/commands/focus.mdx
index bf1f67c959..90364c6dc0 100644
--- a/docs/api/commands/focus.mdx
+++ b/docs/api/commands/focus.mdx
@@ -65,8 +65,9 @@ cy.get('[type="input"]').focus()
 #### Focus, type, and blur a textarea
 
 ```javascript
-// yields the <textarea> for further chaining
-cy.get('textarea').focus().type('Nice Product!').blur()
+cy.get('textarea').focus()
+cy.get('textarea').type('Nice Product!')
+cy.get('textarea').blur()
 ```
 
 ## Notes

From 11b494e299a8d60333d501656b08c36758999b7a Mon Sep 17 00:00:00 2001
From: Jennifer Shehane <shehane.jennifer@gmail.com>
Date: Fri, 16 May 2025 11:00:07 -0400
Subject: [PATCH 2/5] fix more instances of unsafe-to-chain

---
 docs/api/commands/blur.mdx                      |  4 +++-
 docs/api/commands/clear.mdx                     |  9 ++++++---
 docs/api/commands/pause.mdx                     | 17 ++++++++---------
 docs/api/commands/type.mdx                      |  3 ++-
 docs/api/cypress-api/catalog-of-events.mdx      |  4 +---
 docs/api/cypress-api/custom-commands.mdx        |  2 +-
 docs/app/tooling/code-coverage.mdx              |  7 +++----
 .../guides/address-coverage-gaps.mdx            |  3 ++-
 8 files changed, 26 insertions(+), 23 deletions(-)

diff --git a/docs/api/commands/blur.mdx b/docs/api/commands/blur.mdx
index 2d550184f9..5f2c49bf8c 100644
--- a/docs/api/commands/blur.mdx
+++ b/docs/api/commands/blur.mdx
@@ -141,7 +141,9 @@ events. Your best bet here is to keep Cypress focused when working on a test.
 **_Blur a textarea after typing._**
 
 ```javascript
-cy.get('[name="comment"]').focus().type('Nice Product!').blur()
+cy.get('[name="comment"]').focus()
+cy.get('[name="comment"]').type('Nice Product!')
+cy.get('[name="comment"]').blur()
 ```
 
 The commands above will display in the Command Log as:
diff --git a/docs/api/commands/clear.mdx b/docs/api/commands/clear.mdx
index 83e9e7a09c..6b1a5c62a2 100644
--- a/docs/api/commands/clear.mdx
+++ b/docs/api/commands/clear.mdx
@@ -33,7 +33,8 @@ An alias for [`.type('{selectall}{del}')`](/api/commands/type)
 
 ```javascript
 cy.get('[type="text"]').clear() // Clear text input
-cy.get('textarea').type('Hi!').clear() // Clear textarea
+cy.get('textarea').type('Hi!')
+cy.get('textarea').clear() // Clear textarea
 cy.focused().clear() // Clear focused input/textarea
 ```
 
@@ -73,7 +74,8 @@ Pass in an options object to change the default behavior of `.clear()`.
 #### Clear the input and type a new value
 
 ```javascript
-cy.get('textarea').clear().type('Hello, World')
+cy.get('textarea').clear()
+cy.get('textarea').type('Hello, World')
 ```
 
 ## Notes
@@ -117,7 +119,8 @@ Please read the [`.type()`](/api/commands/type) documentation for more details.
 **_Clear the input and type a new value_**
 
 ```javascript
-cy.get('input[name="name"]').clear().type('Jane Lane')
+cy.get('input[name="name"]').clear()
+cy.get('input[name="name"]').type('Jane Lane')
 ```
 
 The commands above will display in the Command Log as:
diff --git a/docs/api/commands/pause.mdx b/docs/api/commands/pause.mdx
index bbffd4946d..e39583934b 100644
--- a/docs/api/commands/pause.mdx
+++ b/docs/api/commands/pause.mdx
@@ -95,15 +95,14 @@ cy.get('button').should('not.be.disabled')
 **_Pause and step through each `.click()` command_**
 
 ```javascript
-cy.get('#action-canvas')
-  .click(80, 75)
-  .pause()
-  .click(170, 75)
-  .click(80, 165)
-  .click(100, 185)
-  .click(125, 190)
-  .click(150, 185)
-  .click(170, 165)
+cy.get('#action-canvas').click(80, 75)
+cy.pause()
+cy.get('#action-canvas').click(170, 75)
+cy.get('#action-canvas').click(80, 165)
+cy.get('#action-canvas').click(100, 185)
+cy.get('#action-canvas').click(125, 190)
+cy.get('#action-canvas').click(150, 185)
+cy.get('#action-canvas').click(170, 165)
 ```
 
 The commands above will display in the Command Log as:
diff --git a/docs/api/commands/type.mdx b/docs/api/commands/type.mdx
index 97f7030c87..f16da3b215 100644
--- a/docs/api/commands/type.mdx
+++ b/docs/api/commands/type.mdx
@@ -378,7 +378,8 @@ cy.get('body').type(
 // execute a SHIFT + click on the first <li>
 // {release: false} is necessary so that
 // SHIFT will not be released after the type command
-cy.get('body').type('{shift}', { release: false }).get('li:first').click()
+cy.get('body').type('{shift}', { release: false })
+  .get('li:first').click()
 ```
 
 ### Options
diff --git a/docs/api/cypress-api/catalog-of-events.mdx b/docs/api/cypress-api/catalog-of-events.mdx
index e6403a261d..71d7ad6a71 100644
--- a/docs/api/cypress-api/catalog-of-events.mdx
+++ b/docs/api/cypress-api/catalog-of-events.mdx
@@ -344,15 +344,13 @@ it('can modify the window prior to page load on all pages', () => {
   cy
     // window:before:load will be called here
     .visit('/first/page')
-
     .then((win) => {
       // and here
       win.location.href = '/second/page'
     })
 
     // and here
-    .get('a')
-    .click()
+  cy.get('a').click()
 })
 ```
 
diff --git a/docs/api/cypress-api/custom-commands.mdx b/docs/api/cypress-api/custom-commands.mdx
index d26669bf78..19d86044ce 100644
--- a/docs/api/cypress-api/custom-commands.mdx
+++ b/docs/api/cypress-api/custom-commands.mdx
@@ -196,7 +196,7 @@ Cypress.Commands.add('loginViaUi', (user) => {
       cy.visit('/login')
       cy.get('input[name=email]').type(user.email)
       cy.get('input[name=password]').type(user.password)
-      cy.click('button#login')
+      cy.get('button#login').click()
       cy.get('h1').contains(`Welcome back ${user.name}!`)
     },
     {
diff --git a/docs/app/tooling/code-coverage.mdx b/docs/app/tooling/code-coverage.mdx
index 5fec61cc6e..8432c05707 100644
--- a/docs/app/tooling/code-coverage.mdx
+++ b/docs/app/tooling/code-coverage.mdx
@@ -388,10 +388,9 @@ completed.
 ```js
 it('adds and completes todos', () => {
   -{cy.visit('/')::cy.mount(<AddTodo />)}-
-  cy.get('.new-todo')
-    .type('write code{enter}')
-    .type('write tests{enter}')
-    .type('deploy{enter}')
+  cy.get('.new-todo').type('write code{enter}')
+  cy.get('.new-todo').type('write tests{enter}')
+  cy.get('.new-todo').type('deploy{enter}')
 
   cy.get('.todo').should('have.length', 3)
 
diff --git a/docs/ui-coverage/guides/address-coverage-gaps.mdx b/docs/ui-coverage/guides/address-coverage-gaps.mdx
index 8c70ea6686..f89c1d8384 100644
--- a/docs/ui-coverage/guides/address-coverage-gaps.mdx
+++ b/docs/ui-coverage/guides/address-coverage-gaps.mdx
@@ -69,7 +69,8 @@ Some gaps occur because elements are hidden or not rendered during tests. Update
 
 ```js
 cy.get('[data-cy="dropdown-toggle"]').click() // Reveal hidden elements
-cy.get('[data-cy="dropdown-item"]').should('be.visible').click()
+cy.get('[data-cy="dropdown-item"]').should('be.visible')
+cy.get('[data-cy="dropdown-item"]').click()
 ```
 
 ### Handle Dynamic Content

From a067e66150a91cdd839277344b7d2393a4638a47 Mon Sep 17 00:00:00 2001
From: Jennifer Shehane <shehane.jennifer@gmail.com>
Date: Fri, 16 May 2025 11:29:58 -0400
Subject: [PATCH 3/5] break out trigger

---
 docs/api/commands/trigger.mdx | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/api/commands/trigger.mdx b/docs/api/commands/trigger.mdx
index 304efaebf1..a7ea3e3de0 100644
--- a/docs/api/commands/trigger.mdx
+++ b/docs/api/commands/trigger.mdx
@@ -129,10 +129,9 @@ To simulate drag and drop using jQuery UI sortable requires `pageX` and `pageY`
 properties along with `which:1`.
 
 ```javascript
-cy.get('[data-cy=draggable]')
-  .trigger('mousedown', { which: 1, pageX: 600, pageY: 100 })
-  .trigger('mousemove', { which: 1, pageX: 600, pageY: 600 })
-  .trigger('mouseup')
+cy.get('[data-cy=draggable]').trigger('mousedown', { which: 1, pageX: 600, pageY: 100 })
+cy.get('[data-cy=draggable]').trigger('mousemove', { which: 1, pageX: 600, pageY: 600 })
+cy.get('[data-cy=draggable]').trigger('mouseup')
 ```
 
 #### Drag and Drop

From 83e24515055bf765d731a5e76ac46c80cd2bc873 Mon Sep 17 00:00:00 2001
From: Jennifer Shehane <shehane.jennifer@gmail.com>
Date: Mon, 19 May 2025 16:46:55 -0400
Subject: [PATCH 4/5] update another example

---
 docs/api/commands/viewport.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/api/commands/viewport.mdx b/docs/api/commands/viewport.mdx
index a340f060f4..e3532ed375 100644
--- a/docs/api/commands/viewport.mdx
+++ b/docs/api/commands/viewport.mdx
@@ -305,7 +305,8 @@ cy.viewport(320, 480)
 
 // the navbar should have collapse since our screen is smaller
 cy.get('#navbar').should('not.be.visible')
-cy.get('.navbar-toggle').should('be.visible').click()
+cy.get('.navbar-toggle').should('be.visible')
+cy.get('.navbar-toggle').click()
 cy.get('.nav').find('a').should('be.visible')
 ```
 

From b9502d038dc30c29628ef53dd93465e25d3d7f85 Mon Sep 17 00:00:00 2001
From: Jennifer Shehane <shehane.jennifer@gmail.com>
Date: Mon, 19 May 2025 16:47:29 -0400
Subject: [PATCH 5/5] lint

---
 docs/api/commands/trigger.mdx              | 12 ++++++++++--
 docs/api/commands/type.mdx                 |  3 +--
 docs/api/cypress-api/catalog-of-events.mdx |  2 +-
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/api/commands/trigger.mdx b/docs/api/commands/trigger.mdx
index a7ea3e3de0..a30a51e49b 100644
--- a/docs/api/commands/trigger.mdx
+++ b/docs/api/commands/trigger.mdx
@@ -129,8 +129,16 @@ To simulate drag and drop using jQuery UI sortable requires `pageX` and `pageY`
 properties along with `which:1`.
 
 ```javascript
-cy.get('[data-cy=draggable]').trigger('mousedown', { which: 1, pageX: 600, pageY: 100 })
-cy.get('[data-cy=draggable]').trigger('mousemove', { which: 1, pageX: 600, pageY: 600 })
+cy.get('[data-cy=draggable]').trigger('mousedown', {
+  which: 1,
+  pageX: 600,
+  pageY: 100,
+})
+cy.get('[data-cy=draggable]').trigger('mousemove', {
+  which: 1,
+  pageX: 600,
+  pageY: 600,
+})
 cy.get('[data-cy=draggable]').trigger('mouseup')
 ```
 
diff --git a/docs/api/commands/type.mdx b/docs/api/commands/type.mdx
index f16da3b215..97f7030c87 100644
--- a/docs/api/commands/type.mdx
+++ b/docs/api/commands/type.mdx
@@ -378,8 +378,7 @@ cy.get('body').type(
 // execute a SHIFT + click on the first <li>
 // {release: false} is necessary so that
 // SHIFT will not be released after the type command
-cy.get('body').type('{shift}', { release: false })
-  .get('li:first').click()
+cy.get('body').type('{shift}', { release: false }).get('li:first').click()
 ```
 
 ### Options
diff --git a/docs/api/cypress-api/catalog-of-events.mdx b/docs/api/cypress-api/catalog-of-events.mdx
index 71d7ad6a71..44c237f31b 100644
--- a/docs/api/cypress-api/catalog-of-events.mdx
+++ b/docs/api/cypress-api/catalog-of-events.mdx
@@ -349,7 +349,7 @@ it('can modify the window prior to page load on all pages', () => {
       win.location.href = '/second/page'
     })
 
-    // and here
+  // and here
   cy.get('a').click()
 })
 ```