chore: update types, integation tests, and add comments

AtofStryker · AtofStryker · commit 05c47e33ab9c · 2025-12-23T10:12:09.000-05:00
diff --git a/cli/types/cypress.d.ts b/cli/types/cypress.d.ts
@@ -3173,6 +3173,11 @@ declare namespace Cypress {
      * @default false
      */
     injectDocumentDomain: boolean
+    /**
+     * Enables the "Run All Specs" UI feature, allowing the execution of multiple specs sequentially.
+     * @default false
+     */
+    experimentalRunAllSpecs?: boolean
     /**
      * Enables AST-based JS/HTML rewriting. This may fix issues caused by the existing regex-based JS/HTML replacement algorithm.
      * @default false
@@ -3274,11 +3279,6 @@ declare namespace Cypress {
   }
 
   interface EndToEndConfigOptions extends Omit<CoreConfigOptions, 'indexHtmlFile'> {
-    /**
-     * Enables the "Run All Specs" UI feature, allowing the execution of multiple specs sequentially.
-     * @default false
-     */
-    experimentalRunAllSpecs?: boolean
     /**
      * Enables support for `Cypress.require()` for including dependencies within the `cy.origin()` callback.
      * @default false
diff --git a/npm/vite-dev-server/client/initCypressTests.js b/npm/vite-dev-server/client/initCypressTests.js
@@ -49,6 +49,7 @@ if (supportFile) {
 
 const specPath = new URLSearchParams(document.location.search).get('specPath')
 
+// if the specPath is __all, then experimentalRunAllSpecs is set to true.
 if (specPath === '__all' || CypressInstance.spec.relative === '__all') {
   const runAllSpecs = window.parent.__RUN_ALL_SPECS__ || []
   const allSpecs = window.parent.__RUN_MODE_SPECS__ || []
diff --git a/packages/data-context/src/sources/HtmlDataSource.ts b/packages/data-context/src/sources/HtmlDataSource.ts
@@ -120,6 +120,7 @@ export class HtmlDataSource {
       <body>
         <script>
           window.__RUN_MODE_SPECS__ = ${JSON.stringify(this.ctx.project.specs)}
+          <!-- __RUN_ALL_SPECS__ is only set if experimentalRunAllSpecs is set to true -->
           window.__RUN_ALL_SPECS__ = ${JSON.stringify(this.ctx.project.runAllSpecs || [])}
           window.__CYPRESS_MODE__ = ${JSON.stringify(this.ctx.isRunMode && !process.env.CYPRESS_INTERNAL_SIMULATE_OPEN_MODE ? 'run' : 'open')};
           window.__CYPRESS_CONFIG__ = ${JSON.stringify(serveConfig)};
diff --git a/packages/server/test/integration/cypress_spec.js b/packages/server/test/integration/cypress_spec.js
@@ -1868,9 +1868,9 @@ describe('lib/cypress', () => {
 
         // "pick" out the list of properties that cannot exist on the root level so we can re-add them on the "e2e" object
         // TODO: refactor this part of the test, this is silly and a holdover from pre-split-config
-        const { experimentalRunAllSpecs, experimentalOriginDependencies, supportFile, specPattern, excludeSpecPattern, baseUrl, slowTestThreshold, testIsolation, ...rest } = json
+        const { experimentalOriginDependencies, supportFile, specPattern, excludeSpecPattern, baseUrl, slowTestThreshold, testIsolation, ...rest } = json
 
-        return settings.writeForTesting(this.todosPath, { ...rest, e2e: { experimentalRunAllSpecs, experimentalOriginDependencies, baseUrl, supportFile, specPattern, testIsolation, excludeSpecPattern } })
+        return settings.writeForTesting(this.todosPath, { ...rest, e2e: { experimentalOriginDependencies, baseUrl, supportFile, specPattern, testIsolation, excludeSpecPattern } })
       }).then(async () => {
         await clearCtx()
 
