faked 一个用于 mock 后端 API 的轻量工具

1、简介

faked 是一个在前端开发中用于 mock 服务端接口的模块，轻量简单，无须要在本地启动 Server 也无需其它更多的资源，仅在浏览器中完成「请求拉截」，配合完整的「路由系统」垂手可得的 mock 后端 API。

GitHub Rep 地址：https://github.com/Houfeng/faked

2、安装 faked

有两种可选安装方式，你能够经过传统的 sciprt 方式引入 faked，若是你采用了 CommonJs 或 ES6 Modules 模块方案，也可经过安装 NPM Pageage 的方式安装依赖。

经过 script 引入：

<script src="your-path/faked.min.js"></script>

经过 npm 安装：

$ npm i faked --save-dev

CommonJs 方式引用

const faked = require('faked');

ES6 Modules 方式引用

import faked from 'faked'

3、基本使用

经过 faked.when 方法你几乎就可使用 faked 的全部功能了，尽管 faked 还提供了一组「快捷方法」，faked.when 方法说明以下：

//指定单一 Http Method
faked.when(<method>, <pattern>, <handler>);

//指定多个 Http Method
faked.when(<methods>, <pattern>, <handler>);

示例，模拟一个获取用户信息的接口，参考以下代码：

faked.when('get','/user/{id}', function(){
  this.send({name:'Bob'});
});

每个 handler 的 this 就是当前请求上下文对象，对象有以下主要成员:

• this.send(data, status, headers) 方法，用于响应一个请求，status 默认为 200
• this.params 路由参数对象，用于访问路由模式中的「路由参数」，如上边示例中的 id
• this.query 解析查询字符串对应的对象，好比 ?name=bob 能够经过 this.query.name 访问
• this.body 请求的主体内容，一般会是一个 json 对象，它取决于发起的请求。

除了使用 send 方法，还能够直接「返回」数据，参考以下代码：

faked.when('get','/user/{id}', function(){
  return {name:'Bob'};
});

固然，在有「异步处理」时你也能够返回一个 promise 对象或像上边那样用 send 方法。若是你只想 mock 数据，还可使用简化写法，参考以下代码：

faked.when('get','/user/{id}', {name:'bob'});

4、快捷方法

faked 还基于 when 方法提供了一组快捷方法，对应经常使用的 Http Methods，包括：

get, post, put, delete, options, patch, head, copy, link, unlink, lock, unlock, view

用 faked.get 写一个示例：

faked.get('/user/{id}',function(){
  this.send({name:'Bob'});
});

其它快捷方法和 faked.get 用法彻底一致。

5、路由系统

在编辑 Mock API 时， faked 提供了路由支持，如上边看到的 /user/{id}，就是一个路由「匹配模式」，其中 {id} 是一个路由参数，当多个路由同时匹配请求的 URL 时，只会触发第一个执行，不一样的 Http Method 的 URL 匹配模式能够相同，并不会冲突。路由参数还能够加「限定表达式」，参考以下代码：

// User Id 只能是数字
faked.get('/user/{id:\d+}', {name:'test'});

6、模拟网络延时

有时候，咱们但愿 Mock API 能延时响应数据，以模拟「网络延时」，faked 目前支持固定的「延时设置」，参考以下代码：

const faked = require('faked');

//全部的请求都将被延时 2 秒种再响应用 mock 数据
faked.delay = 2000;

当 delay 设置 0 时，将禁用延时。

7、设置超时时间

faked 还可设置 Mock API 的最大响应时间，这项设置存在的意义还在于「全部 Mock API 的 Handler 默认都是异步的，若是忘记「返回或 Send」一个响应结果，请求将会被一直挂起，有了超时设置，超时时将会抛出一个错误，方便定位问题」，参考以下代码：

const faked = require('faked');

//在超过 8 秒未响应数据时，将会打印一个错误消息
faked.timeout = 8000;

超时设置和延时设置并不会相互影响，超时计算是从延时结束后开始的。

8、JSONP 处理

faked 除了能 mock 常规的 ajax 和 fetch 请求，还能 mock 经常用来处理跨域问题的 jsonp 请求，faked 有两个参数用于配置 jsonp，参考以下代码：

//指定服务端用于获取「回调函数名」的 「QueryString 参数」
faked.jsonp.param = 'callback'; //默认值为 callback 和 jQuery 一致

//有些 jsonp 服务多是固定了「回调函数名」，能够这样设定
faked.jsonp.callback = 'your-callbak-name';

9、注意事项

faked 是一个「辅助开发」的工具，除非有特殊须要，通常状况下它不该出如今你的生产代码中，因此须要注意：

1. 请勿将 faked 放到「生产环境」的应用或页面中
   
2. 找一个合适的你项目的方式决定什么时引用 faked

好比，在 webpak 中，能够根据环境变量决定入口文件，并只在 mock 的入口文件中引用 faked，示例:

webpack.config.js

module.exports = {
  entry: {
    //根据 NODE_ENV 决定是 index.js 仍是 index.mock.js
    bundle: `./src/index${NODE_ENV=='mock'?'.mock':''}.js`
  },
  output: {
    path: './dist/',
    filename: `./[name]${NODE_ENV == 'prod'?'.min':''}.js`
  },
  devtool: 'source-map',
  module: {
    loaders: [...]
  },
  plugins: [...]
};

而后，在 index.mock.js 中这样写：

require('./mock')
require('./index');

用于存放的 mock 代码的 mock.js 多是这样的：

const faked = require('faked');

faked.get('/user/{id}',function(){
  this.send({name:'Bob'});
});

固然，你能够根据实际状况，安排你的文或目录结构。

-- END --