Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/52cik/express-mockjs
mockjs api middleware for Express
https://github.com/52cik/express-mockjs
express express-mockjs mockjs
Last synced: 2 months ago
JSON representation
mockjs api middleware for Express
- Host: GitHub
- URL: https://github.com/52cik/express-mockjs
- Owner: 52cik
- License: mit
- Created: 2016-09-28T02:31:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-30T08:22:38.000Z (about 7 years ago)
- Last Synced: 2024-11-13T20:42:49.561Z (3 months ago)
- Topics: express, express-mockjs, mockjs
- Language: JavaScript
- Homepage:
- Size: 29.3 KB
- Stars: 50
- Watchers: 7
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# express-mockjs
> express mockjs api middleware for Express
[![Linux Build][travis-image]][travis-url]
[![Coverage Status][coveralls-image]][coveralls-url]
[![Dependencies][dependencies-image]][dependencies-url]
[![node][node-image]][node-url]
[![license MIT][license-image]][license-url]
[中文文档](README.zh-CN.md)
## How to use it
### Installation
``` sh
$ npm install --save-dev express-mockjs
```
----
### Quick start
1. Create a directory `api-server`, then create the file `app.js`, the content is：
``` js
var path = require('path')
var express = require('express')
var mockjs = require('express-mockjs')
var app = express()
// Use the default path '/' (Not recommended)
// app.use(mockjs(path.join(__dirname, 'mocks')))
// Use a custom path '/api'
app.use('/api', mockjs(path.join(__dirname, 'mocks')))
// Here you can add any code.
app.listen(3000);
```
2. Create a `mocks` directory under `api-server` and create `data.json` as follows:
```js
/**
* api interface description
*
* @url /test-api
*/
{
"code": 0,
"result|5": [
{
"uid|+1": 1,
"name": "@name",
"email": "@email"
}
]
}
```
3. Install dependent modules
```sh
$ npm i -S express express-mockjs
```
4. Start
```sh
$ node app.js
# or
$ nodemon app.js
```
> You can then access the to view API documents.
**Recommended using [nodemon][nodemon] to monitor auto restart services**
----
### Mock JSON
* [Mock.js 0.1 doc](https://github.com/nuysoft/Mock/wiki)
* [Mock Sample](http://mockjs-lite.js.org/docs/examples.html)
### Examples
```
.
├── mocks
├── home
⎪ ├── data.json
├── user
⎪ ├── data.js
⎪ ├── data.json
├── game
├── data.json
```
## data.json
`Mock JSON` here is not a real JSON file, and more like a JS file, so you want to use the following format.
> Hypothetical file in 'mocks/home/test.json'
``` js
/**
* Interface function description
*
* @url /api-access-path
*
* Parameter description and other instructions.
* uid: user ID
* name: username
* email: the email
* etc.
*/
{
"code": 0,
"result|5": [
{
"uid|+1": 1,
"name": "@name",
"email": "@email"
}
]
}
```
Then you can access the through the browser.
Of course, you can also use the JS file directly.
``` js
/**
* home page links
*
* @url /home-links
*
* Here you can write a detailed description
* of the parameters of the information.
*/
module.exports = {
"code": function () { // simulation error code, 1/10 probability of error code 1.
return Math.random() < 0.1 ? 1 : 0;
},
"list|5-10": [
{"title": "@title", "link": "@url"}
]
};
```
Or export function.
``` js
/**
* user page - user info
*
* @url /user?uid=233
*
* GET: Request method and parameter
* uid This is the requested userID
*
* Here you can write a detailed description
* of the parameters of the information.
*/
module.exports = function (req) {
var uid = req.query.uid;
if (!uid) {
return {
code: -1,
msg: 'no uid',
}
}
return {
code: 0,
data: {
"uid": +uid,
"name": "@name",
"age|20-30": 1,
"email": "@email",
"date": "@date",
},
};
};
```
[travis-url]: https://travis-ci.org/52cik/express-mockjs
[travis-image]: https://img.shields.io/travis/52cik/express-mockjs/master.svg?label=linux
[coveralls-url]: https://coveralls.io/github/52cik/express-mockjs?branch=master
[coveralls-image]: https://coveralls.io/repos/52cik/express-mockjs/badge.svg?branch=master&service=github
[license-url]: https://opensource.org/licenses/MIT
[license-image]: https://img.shields.io/badge/license-MIT-blue.svg
[dependencies-url]: https://david-dm.org/52cik/express-mockjs
[dependencies-image]: https://img.shields.io/david/52cik/express-mockjs.svg?style=flat
[node-url]: https://nodejs.org
[node-image]: https://img.shields.io/badge/node-%3E%3D%200.10.0-brightgreen.svg
[nodemon]: https://nodemon.io