目前在做一个个人网站,写了一半没有数据填充,也不知道写啥了,就顺带学习下mockjs这个东西,官网上主要介绍它是一个可以随机生成各种类型数据,拦截ajax请求等优点。接下来就近距离结束下mockjs吧!
1.安装
通过npm为自己的项目安装mockjs。
npm install mockjs
安装完成后对mockjs进行使用:
const Mock = require('mockjs')let data = Mock.mock({ 'list|10': [{'id|+1': 1}]})
先不要管里面的语法,这上面生成的是一个对象数组,里面每个元素是一个对象,每个对象的key是从0-9,value是一个对象,对象中的key是id,value是1-10.
这里只介绍commonjs中的用法,其实用es6的模块引入方法也可以,但是最终被babel转义的也是通过require引入的。关于import,require这些区别建议看下
2. 语法规范
mockjs的语法规范包括两部分:
1. 数据模板定义规范2. 数据占位符定义规范
- 数据模板定义规范
数据模板中的属性由三个部分组成:属性名,生成规则,属性值
// 属性名 name// 生成规则 rule// 属性值 value'name|rule': value
Notice:
1. 属性名和生成规则之间用 | 分割。2. 生成规则是可选3. 生成规则有7种格式: (1)'name|min-max': value (2)'name|count': value (3)'name|min-max.dmin-dmax': value (4)'name|min-max.dcount': value (5)'name|count.dmin-dmax': value (6)'name|count.dcount': value (7)'name|+step': value4. 生成规则的含义需要依赖属性值得类型才能确定。5. 属性值中可以含有'@占位符'6. 属性值还指定了最终值得初始值和类型。
(1) 属性值是字符串String
1. name|min-max: string通过重复string生成一个字符串,重复次数大于等于min,小于等于max。这里的重复是指对初始化string的重复次数。2. name|count: string通过重复string生成一个字符串,重复次数等于count。
(2) 属性值是数字Number
1. name|+1 : number属性值自动加1, 初始值为number2. name|min-max: number生成一个大于等于min,小于等于max的整数。3. name|min-max.dmin-dmax: number生成一个浮点数,整数部分大于等于min,小于等于max,小数部分保留dmin到dmax位。Mock.mock({ 'number1|1-100.1-10': 1, 'number2|123.1-10': 1, 'number3|123.3': 1, 'number4|123.10': 1.123})// =>{ "number1": 12.92, "number2": 123.51, "number3": 123.777, "number4": 123.1231091814}
(3)属性值是布尔类型Boolean
1. name|1: boolean随机生成一个布尔值,值为true的概率为1/2, 值为false的概率为1/2。2. name|min-max: value随机生成一个布尔值,值为 value 的概率是 min / (min + max),值为 !value 的概率是 max / (min + max)。
(4)属性值是对象Object
1. name|count: object从属性值object中随机选取count个属性2. name|min-max: object从属性值object中随机选取min到max个属性
(5) 属性值是数组Array
1. name|1: array从属性值array中随机选取一个元素,作为最终值2. name|+1: array从属性值array中顺序选取一个元素,作为最终值3. name|min-max: array通过重复属性值array生成一个新数组,重复次数大于等于min,小于等于max。4. name|count: array通过重复属性值array生成一个新数组,重复次数为count。
(6) 属性值是函数Function
'name': function执行函数 function,取其返回值作为最终的属性值,函数的上下文为属性 'name' 所在的对象。
(7) 属性值是正则表达式RegExp
1. name: regexp根据正则表达式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"}
- 数据占位符定义规范DPD
占位符只是在属性值字符串中占个位置,并不出现在最终的属性值中。占位符格式:
@占位符@占位符(参数 [, 参数])
Notice:
1. 用@来标识其后的字符串是占位符。2. 占位符引用的是Mock.Random中的方法。3. 通过Mock.Random.extend()来扩展自定义占位符。4. 占位符也可以引用数据模板中的属性。5. 占位符会有限引用数据模板中的属性。6. 占位符支持相对路径和绝对路径。
3. Mock.mock()
Mock.mock(rurl?, rtype?, template|function(options))
根据数据模板生成模拟数据Mock.mock(template)
根据数据模板生成模拟数据。Mock.mock(rurl, template)
记录数据模板,当拦截到匹配rurl的ajax请求时,根据数据模板生成模拟数据,并作为响应数据返回。Mock.mock(rurl, function(options))
记录用于生成响应数据的函数。当拦截到匹配rurl的ajax请求时,函数function执行,并把执行结果作为响应数据返回。Mock.mock(rurl, rtype, template)
记录数据模板,当拦截到匹配rurl和rtype的ajax请求时,将根据数据模板生成模拟数据,并作为响应数据返回。Mock.mock(rurl, rtype, function(options))
记录用于生成响应数据的函数。当拦截到匹配rurl和rtype的ajax请求时,函数function(options)将被执行,并把执行结果作为响应数据返回。rurl
标识需要拦截的url,可以是url字符串或者url正则:/\/domain\/list\.json/、'/domian/list.json'。
rtype
可选,标识需要拦截的ajax请求类型。例如GET, POST, PUT, DELETE等。template
可选,标识数据模板,可以是对象或字符串。function(options)
可选,表示用于生成响应数据的函数。options
指向本次请求的ajax选项集,含有url, type和body三个属性。4. Mock.setup()
Mock.setup(setting)
配置拦截ajax请求时的行为。支持的配置项有:timeout。setting
必选,配置项集合timeout
可选,执行拦截的ajax请求的响应时间,单位是毫秒,值可以是正整数。例如400标识400ms后才会返回响应的内容;也可以是200-600这样表示响应时间介于200和600毫秒之间,默认是10-100.Mock.setup({ timeout: 400})Mock.setup({ timeout: '200-600'})
目前,接口 Mock.setup( settings ) 仅用于配置 Ajax 请求,将来可能用于配置 Mock 的其他行为。
5. Mock.Random
Mock.Random是一个工具类,用于生成各种随机数据。
Mock.Random的方法在在数据模板中称为占位符,书写格式为'@占位符(参数,[,参数])'var Random = Mock.RandomRandom.email()// => "n.clark@miller.io"Mock.mock('@email')// => "y.lee@lewis.org"Mock.mock( { email: '@email' } )// => { email: "v.lewis@hall.gov" }
扩展
Mock.Random中的方法与数据模板的‘@占位符’一一对应,在需要时还可以为Mock.Random扩展方法,然后在数据模板中通过'@扩展方法'引用:Random.extend({ constellation: function(date) { var constellations = ['白羊座', '金牛座', '双子座', '巨蟹座', '狮子座', '处女座', '天秤座', '天蝎座', '射手座', '摩羯座', '水瓶座', '双鱼座'] return this.pick(constellations) }})Random.constellation()// => "水瓶座"Mock.mock('@CONSTELLATION')// => "天蝎座"Mock.mock({ constellation: '@CONSTELLATION'})// => { constellation: "射手座"
还有一些其他的生成随机数据的方法,大家可以直接去官网看下,这里就不一一的描述了。地址:
6. Mock.valid()
Mock.valid(template, data)
校验真实数据data是否与数据模板template匹配。template
必选,表示数据模板,可以是对象或者字符串“{ 'list|1-10':[{}] }、'@EMAIL'”data
必选,表示真实数据。var template = { name: 'value1'}var data = { name: 'value2'}Mock.valid(template, data)// =>[ { "path": [ "data", "name" ], "type": "value", "actual": "value2", "expected": "value1", "action": "equal to", "message": "[VALUE] Expect ROOT.name'value is equal to value1, but is value2" }]
7. Mock.toJSONSchema()
Mock.toJSONSchema( template )
把Mock.js风格的数据模板template转换成JSON Schematemplate
必选,表示数据模板,可以是对象或者字符串。关于mock.js的介绍也这么多,这些基本上是根据官文摘抄,但是基本上够我们日常使用。
官文: