Repository navigation
feat!: v3.0.0 - #2692
feat!: v3.0.0#2692
Conversation
|
Important Review skippedToo many files! This PR contains 755 files, which is 455 over the limit of 300. To get a review, reduce the PR to 300 files or fewer by splitting it into smaller PRs or changing its base branch. Usage-priced reviews support at most 300 files. ⚙️ Run configurationConfiguration used: Repository UI Review profile: CHILL Plan: Advanced Run ID: ⛔ Files ignored due to path filters (1)
đź“’ Files selected for processing (755)
You can disable this status message by setting the ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
commit: |
|
All alerts resolved. Learn more about Socket for GitHub. This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored. |
|
Hey @kettanaito, thanks a lot for your great work! Is it possible to include this feature? Here’s the link: #2357 |
|
@dsonet GraphQL subscriptions will likely make it either to 3.0 or even to 2.0. They aren't as tedious to implement with the new architecture now. I've introduced the concept of handlers merging in the recent changes to 2.0 and that was the missing piece for the subscriptions. As always, if your company needs that support in MSW, please consider becoming a sponsor! Thank you. |
Released: v3.0.0 🎉This has been released in v3.0.0.
Get these changes by running the following command: Predictable release automation by Release. |
##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) #### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibilty. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
##### [v3.0.3](https://github.com/mswjs/msw/releases/tag/v3.0.3) #### v3.0.3 (2026-10-10) ##### Bug Fixes - **HandlersController:** dispose of reset handlers ([#2810](mswjs/msw#2810)) ([`3818a81`](mswjs/msw@3818a81)) [@kettanaito](https://github.com/kettanaito) - expose network context on `enable` in network sources ([#2809](mswjs/msw#2809)) ([`d1fe8e6`](mswjs/msw@d1fe8e6)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) #### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibility. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
##### [v3.0.3](https://github.com/mswjs/msw/releases/tag/v3.0.3) #### v3.0.3 (2026-10-10) ##### Bug Fixes - **HandlersController:** dispose of reset handlers ([#2810](mswjs/msw#2810)) ([`3818a81`](mswjs/msw@3818a81)) [@kettanaito](https://github.com/kettanaito) - expose network context on `enable` in network sources ([#2809](mswjs/msw#2809)) ([`d1fe8e6`](mswjs/msw@d1fe8e6)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) #### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibility. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
##### [v3.0.3](https://github.com/mswjs/msw/releases/tag/v3.0.3) #### v3.0.3 (2026-10-10) ##### Bug Fixes - **HandlersController:** dispose of reset handlers ([#2810](mswjs/msw#2810)) ([`3818a81`](mswjs/msw@3818a81)) [@kettanaito](https://github.com/kettanaito) - expose network context on `enable` in network sources ([#2809](mswjs/msw#2809)) ([`d1fe8e6`](mswjs/msw@d1fe8e6)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) #### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibility. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
##### [v3.0.3](https://github.com/mswjs/msw/releases/tag/v3.0.3) #### v3.0.3 (2026-10-10) ##### Bug Fixes - **HandlersController:** dispose of reset handlers ([#2810](mswjs/msw#2810)) ([`3818a81`](mswjs/msw@3818a81)) [@kettanaito](https://github.com/kettanaito) - expose network context on `enable` in network sources ([#2809](mswjs/msw#2809)) ([`d1fe8e6`](mswjs/msw@d1fe8e6)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) #### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibility. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
##### [v3.0.3](https://github.com/mswjs/msw/releases/tag/v3.0.3) #### v3.0.3 (2026-10-10) ##### Bug Fixes - **HandlersController:** dispose of reset handlers ([#2810](mswjs/msw#2810)) ([`3818a81`](mswjs/msw@3818a81)) [@kettanaito](https://github.com/kettanaito) - expose network context on `enable` in network sources ([#2809](mswjs/msw#2809)) ([`d1fe8e6`](mswjs/msw@d1fe8e6)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.2](https://github.com/mswjs/msw/releases/tag/v3.0.2) ##### v3.0.2 (2026-10-03) ##### Bug Fixes - **vite:** support `virtual:msw` imports in vitest ([#2802](mswjs/msw#2802)) ([`e73c381`](mswjs/msw@e73c381)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.1](https://github.com/mswjs/msw/releases/tag/v3.0.1) #### v3.0.1 (2026-09-30) ##### Bug Fixes - treat `CONNECT` requests as the transport mechanism ([#2796](mswjs/msw#2796)) ([`7cad86a`](mswjs/msw@7cad86a)) [@kettanaito](https://github.com/kettanaito) ##### [v3.0.0](https://github.com/mswjs/msw/releases/tag/v3.0.0) #### v3.0.0 (2026-09-28) - v3.0.0 ([#2692](mswjs/msw#2692)) ([`2bb4342`](mswjs/msw@2bb4342)) [@kettanaito](https://github.com/kettanaito) [@Andarist](https://github.com/Andarist) #####⚠️ BREAKING CHANGES - **MSW is now ESM-only** ([#2765](mswjs/msw#2765)). - Deprecate support for Node.js v18 and v20 ([#2729](mswjs/msw#2729)). The minimal supported Node.js version is v22. - `msw/native` is removed in favor of [`@msw/react-native`](https://github.com/mswjs/react-native). - Require TypeScript 5.9 as the minimal version. - Deprecate support for TypeScript 5.1 and 5.2 ([#2730](mswjs/msw#2730)) - `worker.stop()` returns a Promise ([#2724](mswjs/msw#2724)). Awaiting it is relevant only for in-flight critical scenarios. - `graphql` is now exported as `msw/graphql` ([#2691](mswjs/msw#2691)). GraphQL is now handled as a proper optional peer dependency. - Removes the `handleRequest()` utility. Please use the `defineNetwork()` API instead. - `GraphQLLinkHandlers` type has been renamed to `GraphQLLink`. - The `file://` requests now throw in Node.js as they normally do (not supported by `fetch`). - The `Content-Length` request header is now removed by `bypass()`. - HTTP-to-WebSocket upgrade requests performed via `fetch()` now throw in Node.js as they normally do (not supported by `fetch`). - Cookies are no longer managed in Node.js for better compatibility. Instead, whatever is the default behavior of your environment that's the cookie behavior you get. This has no effect on the browser. - WebSocket `connection` life cycle event has been renamed to `websocket:connection` ([#2783](mswjs/msw#2783)). - `onUnhandledRequest` option has been renamed to `onUnhandledFrame`. - The library no longer patches `setTimeout` to circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve. - The library no longer returns a mocked cookie string on `request.headers.get('cookie')` in the handlers. It returns `null` in all environments. Please use the `cookies` resolver argument to have cookie-based logic. ##### Features - Supports Node.js v24 and v26. - Supports TypeScript v6.0 and v7.0. - You can import individual utilities, like `delay` or `passthrough`, from the new `msw/utils` entrypoint for smaller footprint on your bundle. - Support GraphQL v17.0. - Support intercepting page navigations and form submissions ([#2721](mswjs/msw#2721)). - Support GraphQL subscriptions ([#285](mswjs/msw#285), [#2763](mswjs/msw#2763)). - Migrate from `path-to-regexp` to `@msw/url` ([#2678](mswjs/msw#2678)). - Remove the following dependencies: - `graphql` - `path-to-regexp` - `picocolors` - `statuses` - `strict-event-emitter` - Adds a Vite plugin for MSW ([#2781](mswjs/msw#2781)). - Adds a `websocket:error` life cycle event to listen to WebSocket connection errors ([#2784](mswjs/msw#2784)). - Support modifying the intercepted request headers in passthrough scenarios ([#2786](mswjs/msw#2786)). - Support a new WebSocket Extension API that allows for better custom experiences ([#2791](mswjs/msw#2791)). ##### Bug fixes - Fix an issue where preventing a page closure via the `beforeunload` listener would unregister the MSW worker ([#1105](mswjs/msw#1105)). - Fix an issue that caused intermittent test failures in Vitest Browser Mode and Firefox if using `maxWorkers: 1` ([#2726](mswjs/msw#2726)). - Fix an issue where in-flight requests were incorrectly passthrough when performed before calling `worker.stop()` ([#2724](mswjs/msw#2724), [#2597](mswjs/msw#2597)). - Fix an issue where persisting cookies in `localStorage` would cause a maximum quota exceeded errors. - Fix various issues related to the network interception in Node.js.
navigaterequests #1594connectionon thews.linklevel #2481BREAKING CHANGES
msw/nativeis removed in favor of@msw/react-native.Headers.getSetCookie #2730)worker.stop()returns a Promise (fix: await in-flight requests from closing clients #2724). Awaiting it is relevant only for in-flight critical scenarios.graphqlis now exported asmsw/graphql(feat!:msw/graphql,graphqlas an optional peer dependency #2691). GraphQL is now handled as a proper optional peer dependency.handleRequest()utility. Please use thedefineNetwork()API instead.GraphQLLinkHandlerstype has been renamed toGraphQLLink.file://requests now throw in Node.js as they normally do (not supported byfetch).Content-Lengthrequest header is now removed bybypass().fetch()now throw in Node.js as they normally do (not supported byfetch).connectionlife cycle event has been renamed towebsocket:connection(feat(ws): renameconnectionevent towebsocket:connection #2783).onUnhandledRequestoption has been renamed toonUnhandledFrame.setTimeoutto circumvent fake timers in test runners. You should advance the fake timers normally for delayed mocked responses to resolve.request.headers.get('cookie')in the handlers. It returnsnullin all environments. Please use thecookiesresolver argument to have cookie-based logic.Features
delayorpassthrough, from the newmsw/utilsentrypoint for smaller footprint on your bundle.path-to-regexpto@msw/url(feat!: migrate to@msw/url #2678).graphqlpath-to-regexppicocolorsstatusesstrict-event-emitterwebsocket:errorlife cycle event to listen to WebSocket connection errors (feat(ws): addwebsocket:errorevent #2784).Bug fixes
beforeunloadlistener would unregister the MSW worker (My app hooks in beforeunload with a confirmation message and then MSW stops working #1105).maxWorkers: 1(Firefox & Vitest Browser Mode Timing Problems (CI) #2726).worker.stop()(fix: await in-flight requests from closing clients #2724, MSW sometimes still handles requests after worker is stopped #2597).localStoragewould cause a maximum quota exceeded errors.Roadmap
msw/wsmsw/httponUnhandledRequestand remove everything deprecated bymsw/experimental, despite keeping it experimental. This is the time to drop it.msw/graphqlis the only way to consume GraphQL due to optional peer dependency ongraphql.HttpResponseand other common utils re-export frommsw/{xyz}is necessary or not.msw/core?msw/nativetomsw/react-native./nativein favor of@msw/react-nativeor altogether.msw/react-nativeto automatically include any necessary polyfills to be fully functional once imported. If the polyfills are too many, consider@msw/react-native.Revise.defineNetworkand move it out from/experimentalpnpm@11.statuses. That's the only CJS dependency requiring a shim.graphqlversion (d9f389d).postinstallhook in favor of explicitmsw init(Make worker autoupdate an explicit choice #1297, Issue: postinstall breaks during ci installation #2704).cookiepackage since it now ships ESM (drop the shim).undici@latestnow that node@20 is dropped.graphql.*methods. Make GraphQL mocking link-first:graphql.link().src/core/utils/handleRequest.ts, it's no longer used by anything.request:*, websocket via `websocket:*).connection->websocket:connection. Ensure the WebSocket connection life cycle is sufficiently represented with events.websocket:errorevent to listen to any errors.Consider lazy interceptors, if feasible.deferred-promisein favor ofPromise.withResolvers()./node,/nativedirectories.kebab-case.webpackand its dependencies.Add.http.connect(),http.query(), and any other methods we can now intercept. They wont do anything in the browser, let them be. Add Node.js testsutils/internal/checkGlobals'and its usage insrc/core/index.ts.test()consistently.Todos