@nx/jest 23.0.0-beta.17 → 23.0.0-beta.18

package/dist/src/migrations/update-20-0-0/replace-getJestProjects-with-getJestProjectsAsync.md

@@ -0,0 +1,25 @@
+#### Replace Usage of `getJestProjects` with `getJestProjectsAsync`
+
+Replaces the usage of the deprecated `getJestProjects` function with the `getJestProjectsAsync` function.
+
+#### Sample Code Changes
+
+##### Before
+
+```ts title="jest.config.ts"
+import { getJestProjects } from '@nx/jest';
+
+export default {
+  projects: getJestProjects(),
+};
+```
+
+##### After
+
+```ts title="jest.config.ts"
+import { getJestProjectsAsync } from '@nx/jest';
+
+export default async () => ({
+  projects: await getJestProjectsAsync(),
+});
+```

package/dist/src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor.md

@@ -0,0 +1,102 @@
+#### Remove `tsConfig` Option from Jest Executor
+
+Removes the previously deprecated and unused `tsConfig` option from the `@nx/jest:jest` executor configuration in all projects.
+
+#### Examples
+
+Remove the option from the project configuration:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "tsConfig": "apps/myapp/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json"
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts"
+      }
+    }
+  }
+}
+```
+
+Remove the option from a target default using the `@nx/jest:jest` executor:
+
+##### Before
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "tsConfig": "{projectRoot}/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json"
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts"
+      }
+    }
+  }
+}
+```
+
+Remove the option from a target default using the `@nx/jest:jest` executor as the key:
+
+##### Before
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "tsConfig": "{projectRoot}/tsconfig.spec.json"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json"
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts"
+      }
+    }
+  }
+}
+```

package/dist/src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync.md

@@ -0,0 +1,25 @@
+#### Replace Usage of `getJestProjects` with `getJestProjectsAsync`
+
+Replaces the usage of the removed `getJestProjects` function with the `getJestProjectsAsync` function.
+
+#### Sample Code Changes
+
+##### Before
+
+```ts title="jest.config.ts"
+import { getJestProjects } from '@nx/jest';
+
+export default {
+  projects: getJestProjects(),
+};
+```
+
+##### After
+
+```ts title="jest.config.ts"
+import { getJestProjectsAsync } from '@nx/jest';
+
+export default async () => ({
+  projects: await getJestProjectsAsync(),
+});
+```

package/dist/src/migrations/update-21-3-0/rename-test-path-pattern.md

@@ -0,0 +1,147 @@
+#### Rename `testPathPattern` to `testPathPatterns`
+
+Renames the `testPathPattern` option to `testPathPatterns` in the `@nx/jest:jest` executor configuration to align with Jest v30 CLI changes. Read more at the [Jest v30 migration notes](https://jestjs.io/docs/upgrading-to-jest30#--testpathpattern-was-renamed-to---testpathpatterns).
+
+#### Examples
+
+Rename the option in project configuration:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json" {7}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```
+
+Rename the option in project configuration with configurations:
+
+##### Before
+
+```json title="apps/myapp/project.json" {7,10,11}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPattern": "some-regex"
+      },
+      "configurations": {
+        "development": { "testPathPattern": "regex-dev" },
+        "production": { "testPathPattern": "regex-prod" }
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/myapp/project.json" {7,10,11}
+{
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "apps/myapp/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      },
+      "configurations": {
+        "development": { "testPathPatterns": "regex-dev" },
+        "production": { "testPathPatterns": "regex-prod" }
+      }
+    }
+  }
+}
+```
+
+Rename the option in a target default using the `@nx/jest:jest` executor:
+
+##### Before
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json" {7}
+{
+  "targetDefaults": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```
+
+Rename the option in a target default using the `@nx/jest:jest` executor as the key:
+
+##### Before
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPattern": "some-regex"
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json" {6}
+{
+  "targetDefaults": {
+    "@nx/jest:jest": {
+      "options": {
+        "jestConfig": "{projectRoot}/jest.config.ts",
+        "testPathPatterns": "some-regex"
+      }
+    }
+  }
+}
+```

package/dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md

@@ -0,0 +1,51 @@
+#### Replace Removed Matcher Aliases
+
+Replaces removed Jest matcher aliases in test files with their corresponding matchers to align with Jest v30 changes. Read more at the [Jest v30 migration notes](https://jestjs.io/docs/upgrading-to-jest30#jest-expect--matchers).
+
+#### Examples
+
+##### Before
+
+```typescript title="apps/myapp/src/app.spec.ts"
+describe('test', () => {
+  it('should pass', async () => {
+    expect(mockFn).toBeCalled();
+    expect(mockFn).toBeCalledTimes(1);
+    expect(mockFn).toBeCalledWith(arg);
+    expect(mockFn).lastCalledWith(arg);
+    expect(mockFn).nthCalledWith(1, arg);
+    expect(mockFn).toReturn();
+    expect(mockFn).toReturnTimes(1);
+    expect(mockFn).toReturnWith(value);
+    expect(mockFn).lastReturnedWith(value);
+    expect(mockFn).nthReturnedWith(1, value);
+    expect(() => someFn()).toThrowError();
+    expect(() => someFn()).not.toThrowError();
+    await expect(someAsyncFn()).rejects.toThrowError();
+    await expect(someAsyncFn()).resolves.not.toThrowError();
+  });
+});
+```
+
+##### After
+
+```typescript title="apps/myapp/src/app.spec.ts"
+describe('test', () => {
+  it('should pass', async () => {
+    expect(mockFn).toHaveBeenCalled();
+    expect(mockFn).toHaveBeenCalledTimes(1);
+    expect(mockFn).toHaveBeenCalledWith(arg);
+    expect(mockFn).toHaveBeenLastCalledWith(arg);
+    expect(mockFn).toHaveBeenNthCalledWith(1, arg);
+    expect(mockFn).toHaveReturned();
+    expect(mockFn).toHaveReturnedTimes(1);
+    expect(mockFn).toHaveReturnedWith(value);
+    expect(mockFn).toHaveLastReturnedWith(value);
+    expect(mockFn).toHaveNthReturnedWith(1, value);
+    expect(() => someFn()).toThrow();
+    expect(() => someFn()).not.toThrow();
+    await expect(someAsyncFn()).rejects.toThrow();
+    await expect(someAsyncFn()).resolves.not.toThrow();
+  });
+});
+```

package/dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs.md

@@ -0,0 +1,33 @@
+#### Convert Jest Config to CJS
+
+Converts `jest.config.ts` files to `jest.config.cts`. This is needed because Node.js type-stripping in newer versions (22+, 24+) can cause issues with ESM syntax in `.ts` files when the project is configured for CommonJS.
+
+This migration only runs if `@nx/jest/plugin` is registered in `nx.json`.
+
+#### Examples
+
+##### Before
+
+```typescript title="jest.config.ts"
+import { foo } from 'bar';
+import baz from 'qux';
+
+export default {
+  displayName: 'myapp',
+  preset: foo,
+  transform: baz,
+};
+```
+
+##### After
+
+```typescript title="jest.config.cts"
+const { foo } = require('bar');
+const baz = require('qux').default ?? require('qux');
+
+module.exports = {
+  displayName: 'myapp',
+  preset: foo,
+  transform: baz,
+};
+```

package/dist/src/migrations/update-23-0-0/update-snapshot-guide-link.md

@@ -0,0 +1,21 @@
+#### Update Jest Snapshot Guide Link
+
+Updates the snapshot guide link at the top of every `.snap` file from the legacy `https://goo.gl/fbAQLP` to `https://jestjs.io/docs/snapshot-testing`. Jest v30 errors out at test setup time if it sees the old link, so existing snapshot files need to be rewritten before tests can run. Read more at the [Jest v30 migration notes](https://jestjs.io/docs/upgrading-to-jest30).
+
+#### Examples
+
+##### Before
+
+```text title="apps/myapp/src/__snapshots__/example.spec.ts.snap"
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`renders correctly 1`] = `"hello"`;
+```
+
+##### After
+
+```text title="apps/myapp/src/__snapshots__/example.spec.ts.snap"
+// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+
+exports[`renders correctly 1`] = `"hello"`;
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/jest",
-  "version": "23.0.0-beta.17",
+  "version": "23.0.0-beta.18",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -104,11 +104,11 @@
     "semver": "^7.6.3",
     "tslib": "^2.3.0",
     "yargs-parser": "21.1.1",
-    "@nx/devkit": "23.0.0-beta.17",
-    "@nx/js": "23.0.0-beta.17"
+    "@nx/devkit": "23.0.0-beta.18",
+    "@nx/js": "23.0.0-beta.18"
   },
   "devDependencies": {
-    "nx": "23.0.0-beta.17"
+    "nx": "23.0.0-beta.18"
   },
   "publishConfig": {
     "access": "public"