cypress 16.1.0 → 16.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress",
-  "version": "16.1.0",
+  "version": "16.1.1",
   "main": "dist/index.js",
   "scripts": {
     "postinstall": "node dist/index.js --exec install",
@@ -132,8 +132,8 @@
   },
   "buildInfo": {
     "commitBranch": "develop",
-    "commitSha": "83902dc838d4a242e88df8cfa3da8a196c681731",
-    "commitDate": "2026-09-15T01:16:53.000Z",
+    "commitSha": "727c47ba3b3b44f025a7b5c2b050bee4e7313e26",
+    "commitDate": "2026-09-28T20:25:50.000Z",
     "stable": true
   },
   "description": "Cypress is a next generation front end testing tool built for the modern web",

package/react/package.json

@@ -20,7 +20,7 @@
     "@cypress/mount-utils": "0.0.0-development",
     "@testing-library/cypress": "10.1.3",
     "@vitejs/plugin-react": "4.6.0",
-    "axios": "^1.15.1",
+    "axios": "^1.20.0",
     "cypress": "0.0.0-development",
     "eslint": "^9.31.0",
     "jiti": "^2.4.2",

package/react/react/package.json

@@ -20,7 +20,7 @@
     "@cypress/mount-utils": "0.0.0-development",
     "@testing-library/cypress": "10.1.3",
     "@vitejs/plugin-react": "4.6.0",
-    "axios": "^1.15.1",
+    "axios": "^1.20.0",
     "cypress": "0.0.0-development",
     "eslint": "^9.31.0",
     "jiti": "^2.4.2",

package/types/cypress.d.ts

@@ -1124,6 +1124,12 @@ declare namespace Cypress {
      * * `setInterval`
      * * `clearInterval`
      * * `Date` Objects
+     * * `requestAnimationFrame`
+     * * `cancelAnimationFrame`
+     * * `requestIdleCallback`
+     * * `cancelIdleCallback`
+     * * `performance`
+     * * `Intl`
      *
      * The clock starts at the unix epoch (timestamp of 0).
      * This means that when you instantiate new Date in your application,
@@ -1168,13 +1174,14 @@ declare namespace Cypress {
     clock(now: number | Date, options?: Loggable): Chainable<Clock>
     /**
      * Mocks global clock but only overrides specific functions.
+     * Passing `null` for `now` starts the clock at the unix epoch (timestamp of 0).
      *
      * @see https://on.cypress.io/clock
      * @example
      *    // keep current date but override "setTimeout" and "clearTimeout"
      *    cy.clock(null, ['setTimeout', 'clearTimeout'])
      */
-    clock(now: number | Date, functions?: Array<'setTimeout' | 'clearTimeout' | 'setInterval' | 'clearInterval' | 'Date'>, options?: Loggable): Chainable<Clock>
+    clock(now: number | Date | null, functions?: ClockFunction[], options?: Loggable): Chainable<Clock>
     /**
      * Mocks global clock and all functions.
      *
@@ -1245,7 +1252,7 @@ declare namespace Cypress {
      *
      * @see https://on.cypress.io/dblclick
      */
-    dblclick(options?: Partial<ClickOptions>): Chainable<Subject>
+    dblclick(options?: Partial<DblClickOptions>): Chainable<Subject>
     /**
      * Double-click a DOM element at specific corner / side.
      *
@@ -1255,7 +1262,7 @@ declare namespace Cypress {
      * @example
      *    cy.get('button').dblclick('topRight')
      */
-    dblclick(position: PositionType, options?: Partial<ClickOptions>): Chainable<Subject>
+    dblclick(position: PositionType, options?: Partial<DblClickOptions>): Chainable<Subject>
     /**
      * Double-click a DOM element at specific coordinates
      *
@@ -1269,7 +1276,7 @@ declare namespace Cypress {
     cy.get('button').dblclick(15, 40)
     ```
      */
-    dblclick(x: number, y: number, options?: Partial<ClickOptions>): Chainable<Subject>
+    dblclick(x: number, y: number, options?: Partial<DblClickOptions>): Chainable<Subject>
     /**
      * Right-click a DOM element.
      *
@@ -1331,8 +1338,19 @@ declare namespace Cypress {
      *
      * @see https://on.cypress.io/each
      */
-    each<E extends Node = HTMLElement>(fn: (element: JQuery<E>, index: number, $list: E[]) => void): Chainable<JQuery<E>> // Can't properly infer type without breaking down Chainable
-    each(fn: (item: any, index: number, $list: any[]) => void): Chainable<Subject>
+    each<E extends Node = HTMLElement>(fn: (element: JQuery<E>, index: number, $list: JQuery<E>) => void): Chainable<JQuery<E>> // Can't properly infer type without breaking down Chainable
+    each(fn: (item: any, index: number, $list: any) => void): Chainable<Subject>
+    /**
+     * Iterate through an array like structure (arrays or objects with a length property).
+     *
+     * @see https://on.cypress.io/each
+     * @example
+     *    cy.getCookies().each({ timeout: 4000 }, (cookie) => {
+     *      // work with each cookie
+     *    })
+     */
+    each<E extends Node = HTMLElement>(options: Partial<Timeoutable>, fn: (element: JQuery<E>, index: number, $list: JQuery<E>) => void): Chainable<JQuery<E>>
+    each(options: Partial<Timeoutable>, fn: (item: any, index: number, $list: any) => void): Chainable<Subject>
 
     /**
      * Get A DOM element at a specific index in an array of elements.
@@ -1644,6 +1662,24 @@ declare namespace Cypress {
      * @see https://on.cypress.io/nextuntil
      */
     nextUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, filter?: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all following siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/nextuntil
+     */
+    nextUntil<K extends keyof HTMLElementTagNameMap>(selector: K, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<HTMLElementTagNameMap[K]>>
+    /**
+     * Get all following siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/nextuntil
+     */
+    nextUntil<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all following siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/nextuntil
+     */
+    nextUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
 
     /**
      * Filter DOM element(s) from a set of DOM elements. Opposite of `.filter()`
@@ -1756,6 +1792,24 @@ declare namespace Cypress {
      * @see https://on.cypress.io/parentsuntil
      */
     parentsUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, filter?: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all ancestors of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/parentsuntil
+     */
+    parentsUntil<K extends keyof HTMLElementTagNameMap>(selector: K, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<HTMLElementTagNameMap[K]>>
+    /**
+     * Get all ancestors of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/parentsuntil
+     */
+    parentsUntil<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all ancestors of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/parentsuntil
+     */
+    parentsUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
 
     /**
      * Stop cy commands from running and allow interaction with the application under test. You can then "resume" running all commands or choose to step through the "next" commands from the Command Log.
@@ -1843,6 +1897,24 @@ declare namespace Cypress {
      * @see https://on.cypress.io/prevuntil
      */
     prevUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, filter?: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all previous siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/prevuntil
+     */
+    prevUntil<K extends keyof HTMLElementTagNameMap>(selector: K, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<HTMLElementTagNameMap[K]>>
+    /**
+     * Get all previous siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/prevuntil
+     */
+    prevUntil<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
+    /**
+     * Get all previous siblings of each DOM element in a set of matched DOM elements up to, but not including, the element provided, without a filter.
+     *
+     * @see https://on.cypress.io/prevuntil
+     */
+    prevUntil<E extends Node = HTMLElement>(element: E | JQuery<E>, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
     /**
      * An AI-powered command that generates Cypress commands from natural language test steps.
      *
@@ -2175,6 +2247,16 @@ declare namespace Cypress {
      *    })
      */
     spread(fn: (...args: any[]) => void): Chainable<Subject>
+    /**
+     * Expand an array into multiple arguments.
+     * @see https://on.cypress.io/spread
+     * @example
+     *    cy.getCookies().spread({ timeout: 4000 }, (cookie1, cookie2, cookie3) => {
+     *      // each cookie is now an individual argument
+     *    })
+     */
+    spread<S extends object | any[] | string | number | boolean>(options: Partial<Timeoutable>, fn: (...args: any[]) => S): Chainable<S>
+    spread(options: Partial<Timeoutable>, fn: (...args: any[]) => void): Chainable<Subject>
 
     /**
      * Run a task in Node via the plugins file.
@@ -2892,6 +2974,18 @@ declare namespace Cypress {
     cmdKey: boolean
   }
 
+  /**
+   * Object to change the default behavior of .dblclick().
+   */
+  interface DblClickOptions extends ClickOptions {
+    /**
+     * Serially double click multiple elements
+     *
+     * @default true
+     */
+    multiple: boolean
+  }
+
   interface CookieOptions extends Partial<Loggable & Timeoutable> {
     /**
      * Domain to set cookies on or get cookies from
@@ -3857,9 +3951,11 @@ declare namespace Cypress {
     /**
      * Amount to scroll after the element has been scrolled into view
      *
+     * An axis that is left out defaults to 0, so either key may be given alone.
+     *
      * @default {top: 0, left: 0}
      */
-    offset: Offset
+    offset: Partial<Offset>
   }
 
   interface SelectOptions extends Loggable, Timeoutable, Forceable {
@@ -6305,7 +6401,9 @@ declare namespace Cypress {
   }
 
   interface CypressError extends Error {
-    docsUrl?: string
+    // an uncaught exception carries both the originating error's docs url and
+    // Cypress's own, so this is an array whenever more than one applies
+    docsUrl?: string | string[]
     codeFrame?: CodeFrame
   }
 
@@ -6504,6 +6602,23 @@ declare namespace Cypress {
     create(): CommandQueue
   }
 
+  /**
+   * Names of the global functions that `cy.clock()` can override in the browser.
+   */
+  type ClockFunction =
+    | 'setTimeout'
+    | 'clearTimeout'
+    | 'setInterval'
+    | 'clearInterval'
+    | 'Date'
+    | 'requestAnimationFrame'
+    | 'cancelAnimationFrame'
+    | 'requestIdleCallback'
+    | 'cancelIdleCallback'
+    | 'performance'
+    | 'Intl'
+    | 'queueMicrotask'
+
   /**
    * The clock starts at the unix epoch (timestamp of 0). This means that when you instantiate new Date in your application, it will have a time of January 1st, 1970.
    */
@@ -6512,9 +6627,10 @@ declare namespace Cypress {
      * Move the clock the specified number of `milliseconds`.
      * Any timers within the affected range of time will be called.
      * @param time Number in ms to advance the clock
+     * @returns The clock's new `now`, in ms since the unix epoch
      * @see https://on.cypress.io/tick
      */
-    tick(time: number): void
+    tick(time: number): number
     /**
      * Restore all overridden native functions.
      * This is automatically called between tests, so should not generally be needed.

package/vue/package.json

@@ -22,7 +22,7 @@
     "@vitejs/plugin-vue": "6.0.6",
     "@vue/compiler-sfc": "3.2.47",
     "@vue/test-utils": "2.4.6",
-    "axios": "^1.15.1",
+    "axios": "^1.20.0",
     "cypress": "0.0.0-development",
     "rollup": "^4.60.2",
     "typescript": "~5.4.5",

package/vue/vue/package.json

@@ -22,7 +22,7 @@
     "@vitejs/plugin-vue": "6.0.6",
     "@vue/compiler-sfc": "3.2.47",
     "@vue/test-utils": "2.4.6",
-    "axios": "^1.15.1",
+    "axios": "^1.20.0",
     "cypress": "0.0.0-development",
     "rollup": "^4.60.2",
     "typescript": "~5.4.5",