- Introduction
- Getting started
- Philosophy
- Comparison
- Limitations
- Debugging runbook
- FAQ
- Basics
- Concepts
- Network behavior
- Integrations
- API
- CLI
- Best practices
- Recipes
- Cookies
- Query parameters
- Response patching
- Polling
- Streaming
- Network errors
- File uploads
- Responding with binary
- Custom worker script location
- Global response delay
- GraphQL query batching
- Higher-order resolver
- Keeping mocks in sync
- Merging Service Workers
- Mock GraphQL schema
- Remote Request Interception
- Using CDN
- Using custom "homepage" property
- Using local HTTPS
Using custom "homepage" property
When using a custom homepage
property in your package.json
, you may encounter Service Worker registration issues. Consider the following package.json
:
// package.json
{
"homepage": "/my-app"
}
This will treat the /my-app
path as the home directory for your application. However, MSW will still expect you to serve the worker script at the root.
To account for that, you have to provide an explicit Service Worker URL as the serviceWorker.url
option when starting the worker:
// src/index.js
// Read the package.json file to grab the "homepage" value.
import packageJson from '../package.json'
if (process.env.NODE_ENV === 'development') {
const { worker } = await import('./mocks/browser')
await worker.start({
serviceWorker: {
// Provide a custom worker script URL, taking
// the "homepage" into account.
url: `${packageJson.homepage}/mockServiceWorker.js`,
},
})
}