npmpackage.info

Gathering detailed insights and metrics for @mswjs/http-middleware

@mswjs/http-middleware - 0.10.3 | npmpackage.info

@mswjs/http-middleware

Spawn an HTTP server from your request handlers or apply them to an existing server using a middleware.

0.10.3

120

TypeScript

10.20 kB

2.9

Installations

npm install @mswjs/http-middleware

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=18

Node Version

18.20.5

NPM Version

10.8.2 Pull Requests

Open

1

Total

27

Closed

2

Merged

24

Issues

Open

4

Total

26

Closed

22

Releases

v0.10.3

Updated on Jan 12, 2025

v0.10.2

Updated on Oct 25, 2024

v0.10.1

Updated on Apr 24, 2024

v0.10.0

Updated on Apr 05, 2024

v0.9.2

Updated on Nov 26, 2023

v0.9.1

Updated on Nov 07, 2023

View All 13 releases

Languages

TypeScript

JavaScript

TypeScript (95.43%)

JavaScript (4.57%)

Developer

mswjs

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

120 Stars

61 Commits

12 Forks

4 Watchers

2 Branches

15 Contributors

Updated on Jun 11, 2025

Maintainers

View All 15 Contributors

Package Meta Information

Latest Version

0.10.3

Package Id

@mswjs/http-middleware@0.10.3

Unpacked Size

10.20 kB

Size

3.73 kB

File Count

NPM Version

10.8.2

Node Version

18.20.5

Published on

Jan 12, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

`@mswjs/http-middleware`

Spawn an Express server from your Mock Service Worker request handlers or apply them to an existing server using a middleware.

When to use this?

You should always prefer Mock Service Worker for API mocking because it can meet most of your requirements without having to spawn and maintain an actual HTTP server. Please refer to the Getting started tutorial to integrate next-generation API mocking into your application.

There are, however, use cases when this extension can be applicable:

If you wish to curl your mock definitions locally;
When prototyping a Node.js backend implementation;
When integrating API mocking in a complex application architecture (i.e. for dockerized applications).

Getting started

Install

1$ npm install @mswjs/http-middleware

Declare request handlers

1// src/mocks/handlers.js
2import { http, graphql, HttpResponse } from 'msw'
3
4export const handlers = [
5  http.post('/user', () => {
6    return HttpResponse.json({ firstName: 'John' })
7  }),
8  graphql.query('GetUser', () => {
9    return HttpResponse.json({
10      data: {
11        user: {
12          firstName: 'John',
13        },
14      },
15    })
16  }),
17]

Learn more about writing request handlers.

Integration

Option 1: Standalone server

1import { createServer } from '@mswjs/http-middleware'
2import { handlers } from './handlers'
3
4const httpServer = createServer(...handlers)
5
6httpServer.listen(9090)

Option 2: Middleware

1import { createMiddleware } from '@mswjs/http-middleware'
2import app from './app'
3import { handlers } from './handlers'
4
5app.use(createMiddleware(...handlers))

API

`createServer(...handlers: RequestHandler[])`

Establishes a standalone Express server that uses the given request handlers to process all incoming requests.

1import { http, HttpResponse } from 'msw'
2import { createServer } from '@mswjs/http-middleware'
3
4const httpServer = createServer(
5  http.get('/user', () => {
6    return HttpResponse.json({ firstName: 'John' })
7  }),
8)
9
10httpServer.listen(9090)

Making a GET http://localhost:9090/user request returns the following response:

1200 OK
2Content-Type: application/json
3
4{
5  "firstName": "John"
6}

`createMiddleware(...handlers: RequestHandler[])`

Creates an Express middleware function that uses the given request handlers to process all incoming requests.

1import { http, HttpResponse } from 'msw'
2import { createMiddleware } from '@mswjs/http-middleware'
3
4const app = express()
5
6app.use(
7  createMiddleware(
8    http.get('/user', () => {
9      return HttpResponse.json({ firstName: 'John' })
10    }),
11  ),
12)
13
14app.use(9090)

Mentions

David Idol, original implementation.

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

2

Maintained

Determines if the project is "actively maintained".

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.9

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@mswjs/http-middleware

Installations

Developer Guide

No

CommonJS

>=18

18.20.5

10.8.2

Pull Requests

1

27

2

24

Issues

4

26

22

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

@mswjs/http-middleware

When to use this?

Getting started

Install

Declare request handlers

Integration

Option 1: Standalone server

Option 2: Middleware

API

createServer(...handlers: RequestHandler[])

createMiddleware(...handlers: RequestHandler[])

Mentions

10

10

3

2

0

0

0

0

0

0

0

0

2.9

/10

`@mswjs/http-middleware`

`createServer(...handlers: RequestHandler[])`

`createMiddleware(...handlers: RequestHandler[])`