cypress 16.1.1 → 16.2.0

package/dist/bin/cypress

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var cli = require('../cli-BUzHfIQ2.js');
+var cli = require('../cli-AgTnS5LO.js');
 require('../xvfb-CbW2_YXR.js');
 require('os');
 require('bluebird');
@@ -32,7 +32,7 @@ require('commander');
 require('cli-table3');
 require('dayjs');
 require('dayjs/plugin/relativeTime');
-require('../spawn-BNsy7yWl.js');
+require('../spawn-DElwyZHC.js');
 require('child_process');
 require('listr2');
 require('readline');

package/dist/{cli-BUzHfIQ2.js → cli-AgTnS5LO.js}

@@ -13,7 +13,7 @@ var dayjs = require('dayjs');
 var relativeTime = require('dayjs/plugin/relativeTime');
 var chalk = require('chalk');
 var Bluebird = require('bluebird');
-var spawn = require('./spawn-BNsy7yWl.js');
+var spawn = require('./spawn-DElwyZHC.js');
 var os = require('os');
 var listr2 = require('listr2');
 var timers = require('timers/promises');
@@ -3088,7 +3088,7 @@ const cliModule = {
                 .action(function (opts, args) {
                 return xvfb.__awaiter(this, void 0, void 0, function* () {
                     try {
-                        const { default: tapModule } = yield Promise.resolve().then(function () { return require('./tap-E19yanov.js'); });
+                        const { default: tapModule } = yield Promise.resolve().then(function () { return require('./tap-WHD3nHJC.js'); });
                         const code = yield tapModule.start(args || [], _.pick(opts, ['session', 'json', 'timeout']));
                         process.exit(code);
                     }

package/dist/cli.js

@@ -8,8 +8,8 @@ require('commander');
 require('common-tags');
 require('log-symbols');
 require('debug');
-var cli = require('./cli-BUzHfIQ2.js');
-require('./spawn-BNsy7yWl.js');
+var cli = require('./cli-AgTnS5LO.js');
+require('./spawn-DElwyZHC.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');

package/dist/{cypress-D0g_F_Y2.js → cypress-CdDm9AVa.js}

@@ -3,7 +3,7 @@
 var xvfb = require('./xvfb-CbW2_YXR.js');
 var tmp = require('tmp');
 var fs = require('fs-extra');
-var cli$1 = require('./cli-BUzHfIQ2.js');
+var cli$1 = require('./cli-AgTnS5LO.js');
 
 /**
  * Opens Cypress GUI

package/dist/cypress.js

@@ -3,8 +3,8 @@
 require('./xvfb-CbW2_YXR.js');
 require('tmp');
 require('fs-extra');
-require('./cli-BUzHfIQ2.js');
-var cypress = require('./cypress-D0g_F_Y2.js');
+require('./cli-AgTnS5LO.js');
+var cypress = require('./cypress-CdDm9AVa.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');
@@ -33,7 +33,7 @@ require('commander');
 require('cli-table3');
 require('dayjs');
 require('dayjs/plugin/relativeTime');
-require('./spawn-BNsy7yWl.js');
+require('./spawn-DElwyZHC.js');
 require('child_process');
 require('listr2');
 require('readline');

package/dist/exec/spawn.js

@@ -6,7 +6,7 @@ require('os');
 require('child_process');
 require('path');
 require('debug');
-var spawn = require('../spawn-BNsy7yWl.js');
+var spawn = require('../spawn-DElwyZHC.js');
 require('readline');
 require('process');
 require('stream');

package/dist/index.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var xvfb = require('./xvfb-CbW2_YXR.js');
 var minimist = require('minimist');
 var Debug = require('debug');
-var cli$1 = require('./cli-BUzHfIQ2.js');
-var spawn = require('./spawn-BNsy7yWl.js');
-var cypress = require('./cypress-D0g_F_Y2.js');
+var cli$1 = require('./cli-AgTnS5LO.js');
+var spawn = require('./spawn-DElwyZHC.js');
+var cypress = require('./cypress-CdDm9AVa.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');

package/dist/{spawn-BNsy7yWl.js → spawn-DElwyZHC.js}

@@ -546,50 +546,47 @@ function requireFilterTaggedContent () {
 	    /**
 	     * Processes a single line and routes content based on tag positions.
 	     *
-	     * This method handles the complex logic of detecting start and end tags within a line,
-	     * maintaining state across lines, and routing content to the appropriate streams.
-	     * It supports cases where both tags appear on the same line, only one tag appears,
-	     * or no tags appear but the line is part of ongoing tagged content.
+	     * Tags are consumed left to right, so a line may contain any number of tagged
+	     * regions in any order, e.g. `<end><start>text\n` when consecutive tagged writes
+	     * are read as a single chunk. Tagged state carries across lines.
 	     *
 	     * @param line The line to process
 	     */
 	    async processLine(line) {
-	        const startPos = line.indexOf(this.startTag);
-	        const endPos = line.lastIndexOf(this.endTag);
-	        if (startPos >= 0 && endPos >= 0) {
-	            // Both tags on same line
-	            if (startPos > 0) {
-	                await this.pass(line.slice(0, startPos));
+	        let rest = line;
+	        do {
+	            const endPos = rest.indexOf(this.endTag);
+	            if (this.inTaggedContent) {
+	                if (endPos < 0) {
+	                    await this.writeToWasteStream(rest);
+	                    return;
+	                }
+	                if (endPos > 0) {
+	                    await this.writeToWasteStream(rest.slice(0, endPos));
+	                }
+	                this.inTaggedContent = false;
+	                rest = rest.slice(endPos + this.endTag.length);
+	                continue;
 	            }
-	            await this.writeToWasteStream(line.slice(startPos + this.startTag.length, endPos));
-	            if (endPos + this.endTag.length < line.length) {
-	                await this.pass(line.slice(endPos + this.endTag.length));
+	            const startPos = rest.indexOf(this.startTag);
+	            // An end tag without a preceding start tag closes content whose start was not seen
+	            if (endPos >= 0 && (startPos < 0 || endPos < startPos)) {
+	                if (endPos > 0) {
+	                    await this.writeToWasteStream(rest.slice(0, endPos));
+	                }
+	                rest = rest.slice(endPos + this.endTag.length);
+	                continue;
+	            }
+	            if (startPos < 0) {
+	                await this.pass(rest);
+	                return;
 	            }
-	        }
-	        else if (startPos >= 0) {
-	            // Start tag found
 	            if (startPos > 0) {
-	                await this.pass(line.slice(0, startPos));
+	                await this.pass(rest.slice(0, startPos));
 	            }
-	            await this.writeToWasteStream(line.slice(startPos + this.startTag.length));
 	            this.inTaggedContent = true;
-	        }
-	        else if (endPos >= 0) {
-	            // End tag found
-	            await this.writeToWasteStream(line.slice(0, endPos));
-	            if (endPos + this.endTag.length < line.length) {
-	                await this.pass(line.slice(endPos + this.endTag.length));
-	            }
-	            this.inTaggedContent = false;
-	        }
-	        else if (this.inTaggedContent) {
-	            // Currently in tagged content
-	            await this.writeToWasteStream(line);
-	        }
-	        else {
-	            // Not in tagged content
-	            await this.pass(line);
-	        }
+	            rest = rest.slice(startPos + this.startTag.length);
+	        } while (rest.length > 0);
 	    }
 	    async writeToWasteStream(line, encoding) {
 	        var _a;

package/dist/{tap-E19yanov.js → tap-WHD3nHJC.js}

@@ -4,7 +4,7 @@ var xvfb = require('./xvfb-CbW2_YXR.js');
 var Debug = require('debug');
 var commander = require('commander');
 var path = require('path');
-var cli = require('./cli-BUzHfIQ2.js');
+var cli = require('./cli-AgTnS5LO.js');
 var CRI = require('chrome-remote-interface');
 var chalk = require('chalk');
 var crypto = require('crypto');
@@ -33,7 +33,7 @@ require('untildify');
 require('cli-table3');
 require('dayjs');
 require('dayjs/plugin/relativeTime');
-require('./spawn-BNsy7yWl.js');
+require('./spawn-DElwyZHC.js');
 require('child_process');
 require('listr2');
 require('readline');

package/package.json

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

package/types/aria-query/index.d.ts

@@ -0,0 +1,343 @@
+// Disable automatic exports.
+export {};
+
+interface MapLike<Key, Value> {
+    entries: () => Array<[Key, Value]>;
+    get: (key: Key) => Value | undefined;
+    has: (key: Key) => boolean;
+    keys: () => Key[];
+    values: () => Value[];
+}
+
+// index.js
+export type ARIARoleDefinitionKey = ARIAAbstractRole | ARIARole | ARIADPubRole;
+
+export const aria: MapLike<ARIAProperty, ARIAPropertyDefinition>;
+export interface DOMDefinition {
+    reserved?: boolean | undefined;
+    interactive?: boolean | undefined;
+}
+export const dom: MapLike<string, DOMDefinition>;
+export const elementRoles: MapLike<ARIARoleRelationConcept, Set<ARIARoleDefinitionKey>>;
+export const roles: MapLike<ARIARoleDefinitionKey, ARIARoleDefinition>;
+export const roleElements: MapLike<ARIARoleDefinitionKey, Set<ARIARoleRelationConcept>>;
+
+// types
+export type ARIAAbstractRole =
+    | "command"
+    | "composite"
+    | "input"
+    | "landmark"
+    | "range"
+    | "roletype"
+    | "section"
+    | "sectionhead"
+    | "select"
+    | "structure"
+    | "widget"
+    | "window";
+
+export type ARIAWidgetRole =
+    | "button"
+    | "checkbox"
+    | "gridcell"
+    | "link"
+    | "menuitem"
+    | "menuitemcheckbox"
+    | "menuitemradio"
+    | "option"
+    | "progressbar"
+    | "radio"
+    | "scrollbar"
+    | "searchbox"
+    | "slider"
+    | "spinbutton"
+    | "switch"
+    | "tab"
+    | "tabpanel"
+    | "textbox"
+    | "treeitem";
+
+export type ARIACompositeWidgetRole =
+    | "combobox"
+    | "grid"
+    | "listbox"
+    | "menu"
+    | "menubar"
+    | "radiogroup"
+    | "tablist"
+    | "tree"
+    | "treegrid";
+
+export type ARIADocumentStructureRole =
+    | "application"
+    | "article"
+    | "blockquote"
+    | "caption"
+    | "cell"
+    | "columnheader"
+    | "definition"
+    | "deletion"
+    | "directory"
+    | "document"
+    | "emphasis"
+    | "feed"
+    | "figure"
+    | "generic"
+    | "group"
+    | "heading"
+    | "img"
+    | "insertion"
+    | "list"
+    | "listitem"
+    | "math"
+    | "meter"
+    | "none"
+    | "note"
+    | "paragraph"
+    | "presentation"
+    | "row"
+    | "rowgroup"
+    | "rowheader"
+    | "separator"
+    | "strong"
+    | "subscript"
+    | "superscript"
+    | "table"
+    | "term"
+    | "time"
+    | "toolbar"
+    | "tooltip";
+
+export type ARIALandmarkRole =
+    | "banner"
+    | "complementary"
+    | "contentinfo"
+    | "form"
+    | "main"
+    | "navigation"
+    | "region"
+    | "search";
+
+export type ARIALiveRegionRole = "alert" | "log" | "marquee" | "status" | "timer";
+
+export type ARIAWindowRole = "alertdialog" | "dialog";
+
+export type ARIAUncategorizedRole = "code";
+
+export type ARIADPubRole =
+    | "doc-abstract"
+    | "doc-acknowledgments"
+    | "doc-afterword"
+    | "doc-appendix"
+    | "doc-backlink"
+    | "doc-biblioentry"
+    | "doc-bibliography"
+    | "doc-biblioref"
+    | "doc-chapter"
+    | "doc-colophon"
+    | "doc-conclusion"
+    | "doc-cover"
+    | "doc-credit"
+    | "doc-credits"
+    | "doc-dedication"
+    | "doc-endnote"
+    | "doc-endnotes"
+    | "doc-epigraph"
+    | "doc-epilogue"
+    | "doc-errata"
+    | "doc-example"
+    | "doc-footnote"
+    | "doc-foreword"
+    | "doc-glossary"
+    | "doc-glossref"
+    | "doc-index"
+    | "doc-introduction"
+    | "doc-noteref"
+    | "doc-notice"
+    | "doc-pagebreak"
+    | "doc-pagelist"
+    | "doc-part"
+    | "doc-preface"
+    | "doc-prologue"
+    | "doc-pullquote"
+    | "doc-qna"
+    | "doc-subtitle"
+    | "doc-tip"
+    | "doc-toc";
+
+export type ARIARole =
+    | ARIAWidgetRole
+    | ARIACompositeWidgetRole
+    | ARIADocumentStructureRole
+    | ARIALandmarkRole
+    | ARIALiveRegionRole
+    | ARIAWindowRole
+    | ARIAUncategorizedRole;
+
+export interface ARIARoleDefinition {
+    /* Abstract roles may not be used in HTML. */
+    abstract: boolean;
+    /* The concepts in related domains that inform behavior mappings. */
+    baseConcepts: ARIARoleRelation[];
+    /* Child presentational roles strip child nodes of roles and flatten the
+     * content to text. */
+    childrenPresentational: boolean;
+    /* aria-* properties and states disallowed on this role. */
+    prohibitedProps: ARIAPropertyMap;
+    /* aria-* properties and states allowed on this role. */
+    props: ARIAPropertyMap;
+    /* The concepts in related domains that inform behavior mappings. */
+    relatedConcepts: ARIARoleRelation[];
+    /* aria-* properties and states required on this role. */
+    requiredProps: ARIAPropertyMap;
+    /* An array or super class "stacks." Each stack contains a LIFO list of
+     * strings correspond to a super class in the inheritance chain of this
+     * role. Roles may have more than one inheritance chain, which is why
+     * this property is an array of arrays and not a single array. */
+    superClass: Array<Array<ARIAAbstractRole | ARIARole | ARIADPubRole>>;
+}
+
+export type ARIAState =
+    | "aria-busy"
+    | "aria-checked"
+    | "aria-disabled"
+    | "aria-expanded"
+    | "aria-grabbed"
+    | "aria-hidden"
+    | "aria-invalid"
+    | "aria-pressed"
+    | "aria-selected";
+
+export type ARIAProperty =
+    | "aria-activedescendant"
+    | "aria-atomic"
+    | "aria-autocomplete"
+    | "aria-colcount"
+    | "aria-colindex"
+    | "aria-colspan"
+    | "aria-controls"
+    | "aria-current"
+    | "aria-describedby"
+    | "aria-details"
+    | "aria-dropeffect"
+    | "aria-errormessage"
+    | "aria-flowto"
+    | "aria-haspopup"
+    | "aria-keyshortcuts"
+    | "aria-label"
+    | "aria-labelledby"
+    | "aria-level"
+    | "aria-live"
+    | "aria-modal"
+    | "aria-multiline"
+    | "aria-multiselectable"
+    | "aria-orientation"
+    | "aria-owns"
+    | "aria-placeholder"
+    | "aria-posinset"
+    | "aria-readonly"
+    | "aria-relevant"
+    | "aria-required"
+    | "aria-roledescription"
+    | "aria-rowcount"
+    | "aria-rowindex"
+    | "aria-rowspan"
+    | "aria-setsize"
+    | "aria-sort"
+    | "aria-valuemax"
+    | "aria-valuemin"
+    | "aria-valuenow"
+    | "aria-valuetext"
+    | ARIAState;
+
+export interface ARIAPropertyMap {
+    "aria-busy"?: unknown | undefined;
+    "aria-checked"?: unknown | undefined;
+    "aria-disabled"?: unknown | undefined;
+    "aria-expanded"?: unknown | undefined;
+    "aria-grabbed"?: unknown | undefined;
+    "aria-hidden"?: unknown | undefined;
+    "aria-invalid"?: unknown | undefined;
+    "aria-pressed"?: unknown | undefined;
+    "aria-selected"?: unknown | undefined;
+    "aria-activedescendant"?: unknown | undefined;
+    "aria-atomic"?: unknown | undefined;
+    "aria-autocomplete"?: unknown | undefined;
+    "aria-colcount"?: unknown | undefined;
+    "aria-colindex"?: unknown | undefined;
+    "aria-colspan"?: unknown | undefined;
+    "aria-controls"?: unknown | undefined;
+    "aria-current"?: ARIAPropertyCurrent | null | undefined;
+    "aria-describedat"?: unknown | undefined;
+    "aria-describedby"?: unknown | undefined;
+    "aria-details"?: unknown | undefined;
+    "aria-dropeffect"?: unknown | undefined;
+    "aria-errormessage"?: unknown | undefined;
+    "aria-flowto"?: unknown | undefined;
+    "aria-haspopup"?: unknown | undefined;
+    "aria-keyshortcuts"?: unknown | undefined;
+    "aria-label"?: unknown | undefined;
+    "aria-labelledby"?: unknown | undefined;
+    "aria-level"?: unknown | undefined;
+    "aria-live"?: unknown | undefined;
+    "aria-modal"?: unknown | undefined;
+    "aria-multiline"?: unknown | undefined;
+    "aria-multiselectable"?: unknown | undefined;
+    "aria-orientation"?: unknown | undefined;
+    "aria-owns"?: unknown | undefined;
+    "aria-placeholder"?: unknown | undefined;
+    "aria-posinset"?: unknown | undefined;
+    "aria-readonly"?: unknown | undefined;
+    "aria-relevant"?: unknown | undefined;
+    "aria-required"?: unknown | undefined;
+    "aria-roledescription"?: unknown | undefined;
+    "aria-rowcount"?: unknown | undefined;
+    "aria-rowindex"?: unknown | undefined;
+    "aria-rowspan"?: unknown | undefined;
+    "aria-setsize"?: unknown | undefined;
+    "aria-sort"?: unknown | undefined;
+    "aria-valuemax"?: unknown | undefined;
+    "aria-valuemin"?: unknown | undefined;
+    "aria-valuenow"?: unknown | undefined;
+    "aria-valuetext"?: unknown | undefined;
+}
+
+export interface ARIAPropertyDefinition {
+    type: "string" | "id" | "idlist" | "integer" | "number" | "boolean" | "token" | "tokenlist" | "tristate";
+    values?: Array<string | boolean> | undefined;
+    allowundefined?: boolean | undefined;
+}
+
+export type ARIAPropertyCurrent = "page" | "step" | "location" | "date" | "time" | "true" | "false" | true | false;
+
+export interface ARIARoleRelation {
+    module?: string | undefined;
+    concept?: ARIARoleRelationConcept | undefined;
+}
+
+/* The concept in a related domain that informs behavior mappings.
+ * Related domains include: HTML, "Device Independence Delivery Unit", XForms,
+ * and ARIA to name a few. */
+export interface ARIARoleRelationConcept {
+    name: string;
+    attributes?: ARIARoleRelationConceptAttribute[] | undefined;
+    // These constraints are drawn from the mapping between ARIA and HTML:
+    // https://www.w3.org/TR/html-aria
+    constraints?:
+        | Array<
+            | "direct descendant of document"
+            | "direct descendant of ol, ul or menu"
+            | "direct descendant of details element with the open attribute defined"
+            | "descendant of table"
+        >
+        | undefined;
+}
+
+export interface ARIARoleRelationConceptAttribute {
+    name: string;
+    value?: string | number | undefined;
+    // These constraints are drawn from the mapping between ARIA and HTML:
+    // https://www.w3.org/TR/html-aria
+    constraints?: Array<"unset" | ">1"> | undefined;
+}

package/types/cypress.d.ts

@@ -79,6 +79,14 @@ declare namespace Cypress {
     (task: 'net', eventName: string, frame: any): Promise<void>
   }
 
+  /**
+   * Trigger action
+   * @private
+   */
+  interface ActionTrigger {
+    <T = (any[] | void)>(action: string, ...args: any[]): T
+  }
+
   type BrowserName = 'electron' | 'chrome' | 'chromium' | 'firefox' | 'edge' | string
 
   type BrowserChannel = 'stable' | 'canary' | 'beta' | 'dev' | 'nightly' | string
@@ -296,6 +304,25 @@ declare namespace Cypress {
    */
   type AUTWindow = Window & typeof globalThis & ApplicationWindow
 
+  /**
+   * The object yielded by `cy.location()`, describing the current URL of the Application Under Test (AUT).
+   * It is a plain object, not the AUT's `window.location`, so it has no methods such as `assign()` or `reload()`.
+   *
+   * @see https://on.cypress.io/location
+   */
+  interface AUTLocation {
+    hash: string
+    host: string
+    hostname: string
+    href: string
+    origin: string
+    pathname: string
+    port: string
+    protocol: string
+    search: string
+    searchParams: URLSearchParams
+  }
+
   /**
    * The interface for user-defined properties in Window object under test.
    */
@@ -757,7 +784,7 @@ declare namespace Cypress {
      * Trigger action
      * @private
      */
-    action: <T = (any[] | void)>(action: string, ...args: any[]) => T
+    action: ActionTrigger
 
     /**
      * Load files
@@ -1359,7 +1386,7 @@ declare namespace Cypress {
      * @param {Number} index A number indicating the index to find the element at within an array of elements. A negative number counts index from the end of the list.
      * @example
      *    cy.get('tbody>tr').eq(0)    // Yield first 'tr' in 'tbody'
-     *    cy.get('ul>li').eq('4')     // Yield fifth 'li' in 'ul'
+     *    cy.get('ul>li').eq(4)       // Yield fifth 'li' in 'ul'
      *    cy.get('li').eq(-2) // Yields second from last 'li' element
      */
     eq<E extends Node = HTMLElement>(index: number, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
@@ -1481,6 +1508,30 @@ declare namespace Cypress {
      */
     get<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable & Withinable & Shadow>): Chainable<JQuery<E>>
 
+    /**
+     * Get every element with the given ARIA role, optionally narrowed to
+     * those whose accessible name matches `name`. Elements hidden from the
+     * accessibility tree are skipped unless `hidden` is `true`.
+     *
+     * For a role that HTML has an element for, only that element matches by
+     * default: `'button'` finds a `<button>`, not a `<div role="button">`.
+     * Pass `native: false` to also match elements that get the role from a
+     * `role` attribute.
+     *
+     * Chained off an element, it searches that element's descendants.
+     *
+     * @see https://on.cypress.io/getbyrole
+     * @example
+     *    // A native <button>, never a <div role="button">
+     *    cy.getByRole('button', { name: 'Save' }).click()
+     *    // Widgets that HTML has no element for
+     *    cy.getByRole('tab', { name: 'Billing' }).click()
+     *    cy.get('nav').getByRole('menuitem', { name: /delete/i })
+     *    // A dialog rendered as <div role="dialog"> by a component library
+     *    cy.getByRole('dialog', { name: 'Settings', native: false })
+     */
+    getByRole<E extends Node = HTMLElement>(role: import('./aria-query').ARIARole | (string & {}), options?: Partial<GetByRoleOptions>): Chainable<JQuery<E>>
+
     /**
      * Get a browser cookie by its name.
      *
@@ -1576,15 +1627,15 @@ declare namespace Cypress {
     last<E extends Node = HTMLElement>(options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
 
     /**
-     * Get the global `window.location` object of the page that is currently active.
+     * Yield a plain object describing the current URL of the application under test.
      *
      * @see https://on.cypress.io/location
      * @example
      *    cy.location() // Get location object
      */
-    location(options?: Partial<Loggable & Timeoutable>): Chainable<Location>
+    location(options?: Partial<Loggable & Timeoutable>): Chainable<AUTLocation>
     /**
-     * Get a part of the global `window.location` object of the page that is currently active.
+     * Yield one property of a plain object describing the current URL of the application under test.
      *
      * @see https://on.cypress.io/location
      * @example
@@ -1593,7 +1644,7 @@ declare namespace Cypress {
      *    // Assert on the href of the location
      *    cy.location('href').should('contain', '/tag/tutorials')
      */
-    location<K extends keyof Location>(key: K, options?: Partial<Loggable & Timeoutable>): Chainable<Location[K]>
+    location<K extends keyof AUTLocation>(key: K, options?: Partial<Loggable & Timeoutable>): Chainable<AUTLocation[K]>
 
     /**
      * Print a message to the Cypress Command Log.
@@ -1621,7 +1672,7 @@ declare namespace Cypress {
      *
      * @see https://on.cypress.io/next
      * @example
-     *    cy.get('nav a:first').next('.menu-item)
+     *    cy.get('nav a:first').next('.menu-item')
      */
     next<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable>): Chainable<JQuery<E>>
 
@@ -2793,6 +2844,41 @@ declare namespace Cypress {
     timeout: number
   }
 
+  interface GetByRoleOptions extends Loggable, Timeoutable, Shadow {
+    /**
+     * Only match elements whose accessible name matches: the text a screen
+     * reader announces for the element, taken from its label, its content,
+     * `aria-label` or `aria-labelledby`. A string must match the whole name, a
+     * regular expression is tested against it, and a function is called with
+     * the name and the element.
+     */
+    name: string | number | RegExp | ((name: string, element: Element | null) => boolean)
+    /**
+     * Include elements that are hidden from the accessibility tree, such as
+     * those with `aria-hidden="true"`, `display: none` or `visibility: hidden`.
+     *
+     * @default false
+     */
+    hidden: boolean
+    /**
+     * Only match elements whose tag gives them the role, like `<button>`,
+     * skipping elements that only have it through a `role` attribute, like
+     * `<div role="button">`. Set it to `false` to match both.
+     *
+     * Some widely used patterns get their role from a `role` attribute even
+     * though HTML has an element for it, so they need `native: false`: an
+     * `<input role="combobox">` (the native combobox is a `<select>` or an
+     * `<input list>`) and an `<svg role="img">` (the native one is an `<img>`).
+     *
+     * Roles that HTML has no element for, such as `tab` or `menuitem`, can
+     * only come from a `role` attribute, so they are always matched that way.
+     * Passing `native: true` with one of those roles throws.
+     *
+     * @default true for roles that HTML has an element for
+     */
+    native: boolean
+  }
+
   /**
    * Options that check case sensitivity
    */