Motivation
Sometimes I want to mock certain paths of my API made with Express. Therefore, I created fixture-middleware which will use fixture data (mock) for any URL that matches a file inside the configured fixture directory.
Installation
npm install fixture-middleware --save-dev
yarn add fixture-middleware --dev
Usage
const path = const express = const fixtureMiddleware = const app = const fixtureDirectory = path app
Matching URLs with fixture files
All URLs are normalized (all /
will be replaced by --
) and if a Accept
headers is present it will be used to determine the file extension, otherwise the first matching file will be returned.
Example
Suppose we have the following files in the configured fixture directory:
`-- fixtures
|-- users.json
|-- users.html
`-- users--active.json
The following request will match those files as follows
Request | Response |
---|---|
URL: /users Headers: (no accept header) |
File: users.html |
URL: /users Headers: accept=application.json |
File: users.json |
URL: /users Headers: accept=application.html |
File: users.html |
URL: /users/active Headers: (no accept header) |
File: users--active.json |
URL: /users/active Headers: accept=application.json |
File: users--active.json |
Important: Any unmatched request will be delegated to the next middleware.
Development
- Clone and fork this repo.
- Install dependencies: yarn or npm install.
- Run tests.
- Prepare a pull request.
Test
yarn test
– to run all tests.yarn test -- --watch
– to run all tests in watch mode.
Publish
- Bump package version:
yarn version --new-version x.x.x -m 'Version %s.'
. - Publish to NPM registry:
npm publish
. - Push new tag:
git push origin --tags
.
Made with ❤️ by Rubens Mariuzzo.