前端数据模拟MockJS
MockJS是前后端开发一个非常重要的工具。
mockjs介绍
- Mock.js 是一款前端开发中拦截Ajax请求再生成随机数据响应的工具,可以用来模拟服务器响应(前端开发过程中,后端开发暂未完成,前端需要模拟数据进行测试),Mock.js允许正常使用axios发送请求,会被Mock.js拦截,并且可以使用Mock模拟一些数据的响应,当后端开发完成,只需要将Mock移除,前端代码不需要改变。
- 优点是非常简单方便, 无侵入性, 基本覆盖常用的接口数据类型。
- 前后端分离
- 开发无侵入(不需要修改既有代码,就可以拦截 Ajax 请求,返回模拟的响应数据。)
- 数据类型丰富(支持生成随机的文本、数字、布尔值、日期、邮箱、链接、图片、颜色等。)
- 增加单元测试的真实性(通过随机数据,模拟各种场景。)
- 用法简单、符合直觉的接口。
- 方便扩展(支持支持扩展更多数据类型,支持自定义函数和正则。)
- Mock安装:
npm install mockjs
mockjs基本使用
基本使用
在项目中创建mock目录,新建index.js文件
//引入mockjs
import Mock from 'mockjs'
//设置延迟时间:4000ms
// Mock.setup({
// timeout:4000
// })
//使用mockjs模拟数据
Mock.mock('/product/search', {
"ret": 0,
"data": {
"mtime": "@datetime", //随机生成日期时间
"score|1-800": 1, //随机生成1-800的数字,后面的1表示要确定生成的类型为一个数字
"rank|1-100": 1, //随机生成1-100的数字
"stars|1-5": 1, //随机生成1-5的数字
"nickname": "@cname", //随机生成中文名字
//生成图片(长×宽 单位为像素,背景颜色,内部文字颜色,格式,图片内部文字)
"img": "@image('200x100', '#ffcc33', '#FFF', 'png', 'Fast Mock')"
}
});
main.js里面引入
import './mock'
import Vue from 'vue'
import App from './App.vue'
import './mock'
Vue.config.productionTip = false
new Vue({
render: h => h(App),
}).$mount('#app')
App.vue
<template>
<div id="app">
<!-- <img alt="Vue logo" src="./assets/logo.png"> -->
<img alt="image" :src="img">
</div>
</template>
<script>
import axios from 'axios'
export default {
name: 'App',
data:function(){
return {
img:""
}
},
mounted:function(){
axios.get("/product/search").then(res=>{
console.log(res)
console.log(res.data.data.img)
this.img=res.data.data.img
})
}
}
</script>
<style>
#app {
font-family: Avenir, Helvetica, Arial, sans-serif;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
text-align: center;
color: #2c3e50;
margin-top: 60px;
}
</style>
运行结果:
运行成功后获取到的数据
核心方法
Mock.mock( rurl?, rtype?, template|function( options ) )
- rurl,表示需要拦截的 URL,可以是 URL 字符串或 URL 正则
- rtype,表示需要拦截的 Ajax 请求类型。例如 GET、POST、PUT、DELETE 等。
- template,表示数据模板,可以是对象或字符串
- function,表示用于生成响应数据的函数。
- 设置延时请求到数据
数据生成规则
mock的语法规范包含两层规范:
数据模板 (DTD)
数据占位符 (DPD)
1. 数据模板DTD
基本语法
数据模板中的每个属性由 3 部分构成:属性名name(根据业务自定义)、生成规则rule、属性值value(可以是固定的值,也可以是数据占位符随机生成的值):
'name|rule': value
属性名和生成规则之间用竖线 | 分隔,生成规则是可选的
生成规则 有 7 种格式:
'name|min-max': value
'name|count': value
'name|min-max.dmin-dmax': value
'name|min-max.dcount': value
'name|count.dmin-dmax': value
'name|count.dcount': value
'name|+step': value
生成规则的含义需要依赖属性值的类型才能确定。
属性值中可以含有 @占位符 。
属性值还指定了最终值的初始值和类型。
生成规则和示例
- 属性值是字符串String
//通过重复 string 生成一个字符串,重复次数大于等于 min,小于等于 max。
'name|min-max': string
//通过重复 string 生成一个字符串,重复次数等于 count。
'name|count': string
var data = Mock.mock({
'name1|1-3':'a', //重复生成1到3个a(随机)
'name2|2':'b' //生成bb
})
- 属性值是数字Number
//属性值自动加 1,初始值为 number。
'name|+1': number
//生成一个大于等于 min、小于等于 max 的整数,属性值 number 只是用来确定类型。
'name|min-max': number
//生成一个浮点数,整数部分大于等于 min、小于等于 max,小数部分保留 dmin 到 dmax 位。
'name|min-max.dmin-dmax': number
Mock.mock({
'number1|1-100.1-10': 1, //后面的数字1表示生成的数据类型为一个数字(1-10表示保留两位小数)
'number2|123.1-10': 1,
'number3|123.3': 1, //生成3位小数
'number4|123.10': 1.123 //生成10位小数
})
//结果:
{
"number1": 12.92,
"number2": 123.51,
"number3": 123.777,
"number4": 123.1231091814
}
var data = Mock.mock({
'name1|+1':4, //生成4,如果循环每次加1
‘name2|1-7':2, //生成一个数字,1到7之间
'name3|1-4.5-8':1 生成一个小数,整数部分1到4,小数部分5到8位,数字1只是为了确
定类型
})
- 属性值是Boolean
//随机生成一个布尔值,值为 true 的概率是 1/2,值为 false 的概率同样是 1/2。
'name|1': boolean
//随机生成一个布尔值,值为 value 的概率是 min / (min + max),值为 !value 的概率是 max /
(min + max)。
'name|min-max': value
var data = Mock.mock({
'name|1':true, //生成一个布尔值,各一半
'name1|1-3':true //1/4是true,3/4是false
})
- 属性值是对象Object
//从属性值 object 中随机选取 count 个属性。
'name|count': object
//从属性值 object 中随机选取 min 到 max 个属性。
'name|min-max': object
//先自定义一个对象
var obj = {
a:1,
b:2,
c:3,
d:4
}
//name为一个对象
var data = Mock.mock({
'name|1-3':obj, //随机从obj中寻找1到3个属性,新对象
'name|2':obj //随机从onj中找到两个属性,新对象
})
- 属性值是数组Array
//从属性值 array 中随机选取 1 个元素,作为最终值。
'name|1': array
//从属性值 array 中顺序选取 1 个元素,作为最终值。
'name|+1': array
//通过重复属性值 array 生成一个新数组,重复次数大于等于 min,小于等于 max。
'name|min-max': array
//通过重复属性值 array 生成一个新数组,重复次数为 count。
'name|count': array
Mock.mock({
//通过重复属性值 array 生成一个新数组,重复次数为 1-3次。
"favorite_games|1-3": [3,5,4,6,23,28,42,45],
});
var arr = [1,2,3];
var data = Mock.mock({
'name1|1':arr, //从数组里随机取出1个值
'name2|2':arr, //数组重复count次,这里count为2
'name3|1-3':arr, //数组重复1到3次
})
- 属性值是函数 Function
执行函数 function,取其返回值作为最终的属性值,函数的上下文为属性 ‘name’ 所在的对象。
'name': function
var fun = function(x){
return x+10;
}
var data = Mock.mock({
'name':fun(10) //返回函数的返回值20
})
- 属性值是正则表达式 RegExp
根据正则表达式 regexp 反向生成可以匹配它的字符串。用于生成自定义格式的字符串。
'name': regexp
Mock.mock({
'regexp1': /[a-z][A-Z][0-9]/,
'regexp2': /\w\W\s\S\d\D/,
'regexp3': /\d{5,10}/
})
// =>
{
"regexp1": "pJ7",
"regexp2": "F)\fp1G",
"regexp3": "561659409"
}
例如匹配带参数的请求url:
App.vue
mounted:function(){
// axios.get("/product/search").then(res=>{
// console.log(res)
// console.log(res.data.data.img)
// this.img=res.data.data.img
// })
axios.get("/product/search?id=10").then(res=>{
console.log(res)
console.log(res.data.data.img)
this.img=res.data.data.img
})
}
src/mock/index.js
//带参数请求方式:使用正则表达式,.*表示任意字符
Mock.mock(RegExp('/product/search.*'), {
"ret": 0,
"data": {
"mtime": "@datetime", //随机生成日期时间
"score|1-800": 1, //随机生成1-800的数字,后面的1表示要确定生成的类型为一个数字
"rank|1-100": 1, //随机生成1-100的数字
"stars|1-5": 1, //随机生成1-5的数字
"nickname": "@cname", //随机生成中文名字
//生成图片(长×宽 单位为像素,背景颜色,内部文字颜色,格式,图片内部文字)
"img": "@image('200x100', '#ffcc33', '#FFF', 'png', 'Fast Mock')"
}
});
2. 数据占位符DPD
占位符只是在属性值字符串中占个位置,并不出现在最终的属性值中。
占位符的格式为:
@占位符
@占位符(参数 [, 参数])
关于占位符需要知道以下几点:
- 用 @ 标识符标识后面的字符串是占位符
- 占位符 引用的是 Mock.Random 中的方法。
- 可以通过 Mock.Random.extend() 来扩展自定义占位符。
- 占位符 也可以引用 数据模板 中的属性。
- 占位符 会优先引用 数据模板 中的属性。
- 占位符 支持 相对路径 和 绝对路径。
//引入mockjs
import Mock from 'mockjs'
//使用mockjs模拟数据
Mock.mock('/api/msdk/proxy/query_common_credit', {
"ret":0,
"data":
{
"mtime": "@datetime",//随机生成日期时间
"score": "@natural(1, 800)",//随机生成1-800的数字
"rank": "@natural(1, 100)",//随机生成1-100的数字
"stars": "@natural(0, 5)",//随机生成1-5的数字
"nickname": "@cname",//随机生成中文名字
}
});
3. 用例
基础随机内容的生成
{
"string|1-10": "=", // 随机生成1到10个等号
"string2|3": "=", // 随机生成2个或者三个等号
"number|+1": 0, // 从0开始自增
"number2|1-00.1-3": 1, // 生成一个小数,小数点前面1到10,小数点后1到3位
"boolean": "@boolean( 1, 2, true )", // 生成boolean值 三个参数,1表示第三个参数true
出现的概率,2表示false出现的概率
"name": "@cname", // 随机生成中文姓名
"firstname": "@cfirst", // 随机生成中文姓
"int": "@integer(1, 10)", // 随机生成1-10的整数
"float": "@float(1,2,3,4)", // 随机生成浮点数,四个参数分别为,整数部分的最大最小值和小
数部分的最大最小值
"range": "@range(1,100,10)", // 随机生成整数数组,三个参数为,最大最小值和加的步长
"natural": "@natural(60, 100)", // 随机生成自然数(大于零的数)
"email": "@email", // 邮箱
"ip": "@ip" ,// ip
"datatime": "@date('yy-MM-dd hh:mm:ss')" // 随机生成指定格式的时间
// ......
}
列表数据
{
"code": "0000",
"data": {
"pageNo": "@integer(1, 100)",
"totalRecord": "@integer(100, 1000)",
"pageSize": 10,
"list|10": [{
"id|+1": 1,
"name": "@cword(10)",
"title": "@cword(20)",
"descript": "@csentence(20,50)",
"price": "@float(10,100,10,100)"
}]
},
"desc": "成功"
}
图片
mockjs可以生成任意大小,任意颜色块,且用文字填充内容的图片,使我们不用到处找图片资源就能轻松实现图片的模拟展示
{
"code": "0000",
"data": {
"pageNo": "@integer(1, 100)",
"totalRecord": "@integer(100, 1000)",
"pageSize": 10,
"list|10": [{
// 参数从左到右依次为,图片尺寸,背景色,前景色(及文字颜色),图片格式,图片中间的填充文
字内容
"image": "@image('200x100', '#ffcc33', '#FFF', 'png', 'Fast Mock')"
}]
},
"desc": "成功"
}
4. Mock.Random
@开头的占位符最终都是调用Mock内置的Random工具类
Mock.Random 是一个工具类,用于生成各种随机数据。
Mock.Random 的方法在数据模板中称为『占位符』,书写格式为 @占位符(参数 [, 参数]) 。
用法示例:
var Random = Mock.Random
Random.email()
// => "[email protected]"
Mock.mock('@email') //@email即调用Random.email()方法
// => "[email protected]"
Mock.mock( {
email: '@email' } )
// => { email: "[email protected]" }
Mock.Random 提供的完整方法(占位符)如下: