Upgrade Cypress To TypeScript v6

Finally, it has happened. Cypress v15.14 supports TypeScript v6. This is a big deal - TypeScript v6 is the last step before TypeScript v7 which is implemented in Go and is much faster. By the way, you can try TypeScript v7 beta today. So what do you need to switch your projects to use TS v6 with Cypress? It is pretty straightforward:

• check out the TypeScript v6 changes, for example this is a good summary
• switch module resolution from "node" to "bundler" and let Cypress use WebPack to bundle the transpiled code

  {
    "compilerOptions": {
-     "moduleResolution": "node",
+     "moduleResolution": "bundler"
    }
  }

• remove the "target" transpile option, since it is assumed to be the current ES standard (es2025)
• remove the allowSyntheticDefaultImports: true option, since it defaults to it
• remove the baseUrl option UNLESS you are using TypeScript aliases in your specs.

If you are using path aliases in your specs like this:

tsconfig.json

{
  "compilerOptions": {
    "paths": {
      "@support/*": ["./cypress/support/*"],
      "@fixtures/*": ["./cypress/fixtures/*"]
    }
  }
}

cypress/e2e/cart/add-to-cart.cy.ts

import { LoginPage } from '@support/pages/login.page'
import { InventoryPage } from '@support/pages/inventory.page'

Then without baseUrl the Webpack gets lost trying to find the import 🙁

So for now, put the baseUrl back into your tsconfig.json and just point at the current tsconfig.json folder. Add "ignoreDeprecations": "6.0" option to avoid everything screaming at you

tsconfig.json

{
  "compilerOptions": {
    "baseUrl": "./",
    "ignoreDeprecations": "6.0",
    "paths": {
      "@support/*": ["./cypress/support/*"],
      "@fixtures/*": ["./cypress/fixtures/*"]
    }
  }
}

All relative paths in the paths map are relative to the tsconfig.json file.

Happy TypeScripting!