chore: Open in IDE button for block and hook definitions in Runner UI

.circleci/workflows.yml

@@ -1678,7 +1678,7 @@ jobs:
             # run type checking for each individual package
             - run: yarn lerna run types
             - verify-mocha-results:
-                expectedResultCount: 19
+                expectedResultCount: 20
       - store_test_results:
           path: /tmp/cypress
       # CLI tests generate HTML files with sample CLI command output

cli/CHANGELOG.md

@@ -55,6 +55,7 @@ in this [GitHub issue](https://github.com/cypress-io/cypress/issues/30447). Addr
 - Fixed a visibility issue for elements with `textContent` but without a width or height. Fixed in [#29688](https://github.com/cypress-io/cypress/pull/29688). Fixes [#29687](https://github.com/cypress-io/cypress/issues/29687).
 - Elements whose parent elements has `overflow: clip` and no height/width will now correctly show as hidden. Fixed in [#29778](https://github.com/cypress-io/cypress/pull/29778). Fixes [#23852](https://github.com/cypress-io/cypress/issues/23852).
 - The CSS pseudo-class `:dir()` is now supported when testing in Electron. Addresses [#29766](https://github.com/cypress-io/cypress/issues/29766).
+- The Open in IDE button next to blocks and hooks in the runner UI will now properly open the IDE. This bug was introduced in a prerelease version of Cypress 14.0.0. Fixed in [#30859](https://github.com/cypress-io/cypress/pull/30859). Fixes [#30847](https://github.com/cypress-io/cypress/issues/30847).
 
 **Misc:**
 

package.json

@@ -54,7 +54,7 @@
     "stop-only": "npx stop-only --skip .cy,.publish,.projects,node_modules,dist,dist-test,fixtures,lib,bower_components,src,__snapshots__ --exclude cypress-tests.ts,*only.cy.js",
     "stop-only-all": "yarn stop-only --folder packages",
     "pretest": "yarn ensure-deps",
-    "test": "yarn lerna exec yarn test --scope=cypress --scope=@packages/{config,data-context,electron,errors,extension,https-proxy,launcher,net-stubbing,network,packherd-require,proxy,rewriter,scaffold-config,socket,v8-snapshot-require,telemetry} --scope=@tooling/{electron-mksnapshot,v8-snapshot}",
+    "test": "yarn lerna exec yarn test --scope=cypress --scope=@packages/{config,data-context,driver,electron,errors,extension,https-proxy,launcher,net-stubbing,network,packherd-require,proxy,rewriter,scaffold-config,socket,v8-snapshot-require,telemetry} --scope=@tooling/{electron-mksnapshot,v8-snapshot}",
     "test-debug": "lerna exec yarn test-debug --ignore=@packages/{driver,root,static,web-config}",
     "test-integration": "lerna exec yarn test-integration --ignore=@packages/{driver,root,static,web-config}",
     "test-mocha": "mocha --reporter spec scripts/spec.js",
@@ -278,5 +278,6 @@
     "devtools-protocol": "0.0.1346313",
     "sharp": "0.29.3",
     "vue-template-compiler": "2.6.12"
-  }
+  },
+  "packageManager": "[email protected]+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }

packages/driver/package.json

@@ -10,7 +10,9 @@
     "cypress:run:inject-document-domain": "node ../../scripts/cypress run --config-file ./cypress.config-injectDocumentDomain.ts",
     "postinstall": "patch-package",
     "lint": "eslint --ext .js,.jsx,.ts,.tsx,.json, .",
-    "start": "node -e 'console.log(require(`chalk`).red(`\nError:\n\tRunning \\`yarn start\\` is no longer needed for driver/cypress tests.\n\tWe now automatically spawn the server in e2e.setupNodeEvents config.\n\tChanges to the server will be watched and reloaded automatically.`))'"
+    "start": "node -e 'console.log(require(`chalk`).red(`\nError:\n\tRunning \\`yarn start\\` is no longer needed for driver/cypress tests.\n\tWe now automatically spawn the server in e2e.setupNodeEvents config.\n\tChanges to the server will be watched and reloaded automatically.`))'",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
   },
   "dependencies": {},
   "devDependencies": {
@@ -58,6 +60,7 @@
     "jimp": "0.22.12",
     "jquery": "3.7.1",
     "js-cookie": "3.0.5",
+    "jsdom": "^26.0.0",
     "json-stable-stringify": "1.0.1",
     "lodash": "^4.17.21",
     "md5": "2.3.0",
@@ -81,6 +84,7 @@
     "url-parse": "1.5.10",
     "vanilla-text-mask": "5.1.1",
     "vite": "5.2.11",
+    "vitest": "^2.1.8",
     "webpack": "^5.88.2",
     "zone.js": "0.9.0"
   },

packages/driver/src/cy/commands/actions/scroll.ts

@@ -128,6 +128,7 @@ export default (Commands, Cypress, cy, state) => {
       const scrollIntoView = () => {
         return new Promise((resolve, reject) => {
           // scroll our axes
+          // @ts-expect-error - scrollTo does not define a 'done()' key on its config object.
           return $(options.$parent).scrollTo(options.$el, {
             axis: options.axis,
             easing: options.easing,

packages/driver/src/cypress/stack_utils.ts

@@ -108,9 +108,17 @@ const stackWithUserInvocationStackSpliced = (err, userInvocationStack): StackAnd
   }
 }
 
-type InvocationDetails = MessageLineDetail | {}
+type InvocationDetails = {
+  absoluteFile?: string
+  column?: number
+  line?: number
+  originalFile?: string
+  relativeFile?: string
+  stack: string
+}
 
-const getInvocationDetails = (specWindow, config) => {
+// used to determine codeframes for hook/test/etc definitions rather than command invocations
+const getInvocationDetails = (specWindow, config): InvocationDetails | undefined => {
   if (specWindow.Error) {
     let stack = (new specWindow.Error()).stack
 
@@ -120,10 +128,14 @@ const getInvocationDetails = (specWindow, config) => {
     // firefox and chrome throw stacks that include lines from cypress
     // So we drop the lines until we get to the spec stackframe (includes __cypress)
     if (specWindow.Cypress) {
-      stack = stackWithLinesDroppedFromMarker(stack, '__cypress', true)
+      // The stack includes frames internal to cypress, after the spec stackframe. In order
+      // to determine the invocation details, the stack needs to be parsed and trimmed.
+
+      // in Chrome and Firefox, the spec stackframe includes the pattern, '__cypress/tests'.
+      stack = stackWithLinesDroppedFromMarker(stack, '__cypress/tests', true)
     }
 
-    const details: InvocationDetails = getSourceDetailsForFirstLine(stack, config('projectRoot')) || {};
+    const details: Omit<InvocationDetails, 'stack'> = getSourceDetailsForFirstLine(stack, config('projectRoot')) || {};
 
     (details as any).stack = stack
 

packages/driver/test/unit/cypress/stack_utils.spec.ts

@@ -0,0 +1,68 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { vi, describe, it, expect, beforeEach } from 'vitest'
+
+import source_map_utils from '../../../src/cypress/source_map_utils'
+import stack_utils from '../../../src/cypress/stack_utils'
+import stackFrameFixture from './__fixtures__/spec_stackframes.json'
+
+vi.mock('../../../src/cypress/source_map_utils', () => {
+  return {
+    default: {
+      getSourcePosition: vi.fn(),
+    },
+  }
+})
+
+describe('stack_utils', () => {
+  beforeEach(() => {
+    // @ts-expect-error
+    global.Cypress = {
+      config: vi.fn(),
+    }
+
+    vi.resetAllMocks()
+  })
+
+  describe('getInvocationDetails', () => {
+    const { line, column, scenarios } = stackFrameFixture
+
+    const projectRoot = '/foo/bar'
+
+    let stack: string
+
+    class MockError {
+      get stack () {
+        return stack
+      }
+    }
+    const config = () => projectRoot
+
+    for (const scenario of scenarios) {
+      const { browser, build, specFrame, stack: scenarioStack } = scenario
+
+      describe(`${browser}:${build}`, () => {
+        beforeEach(() => {
+          stack = scenarioStack
+        })
+
+        it('calls getSourcePosition with the correct file, line, and column', () => {
+          stack_utils.getInvocationDetails(
+            { Error: MockError, Cypress: {} },
+            config,
+          )
+
+          // getSourcePosition is not called directly from getInvocationDetails, but via:
+          // - getSourceDetailsForFirstLine
+          // - getSourceDetailsForLine
+          expect(source_map_utils.getSourcePosition).toHaveBeenCalledWith(specFrame, expect.objectContaining({
+            column,
+            line,
+            file: specFrame,
+          }))
+        })
+      })
+    }
+  })
+})

packages/driver/tsconfig.json

@@ -13,9 +13,11 @@
     "noEmit": true,
     "outDir": "dist",
     "noErrorTruncation": true,
-    "types": []
+    "types": [],
+    "resolveJsonModule": true
   },
   "exclude": [
-    "dist"
+    "dist",
+    "test"
   ]
 }

packages/driver/vitest.config.mjs

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['test/unit/**/*.spec.ts'],
+    environment: 'jsdom',
+    exclude: ['**/__fixtures__/**/*'],
+    reporters: [
+      'default',
+      ['junit', { suiteName: 'Driver Unit Tests', outputFile: '/tmp/cypress/junit/driver-test-results.xml' }],
+    ],
+  },
+})