php+mockjs,关于mockjs的使用

目前在做一个个人网站，写了一半没有数据填充，也不知道写啥了，就顺带学习下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': value

4. 生成规则的含义需要依赖属性值得类型才能确定。

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， 初始值为number

2. 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.Random

Random.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: "射手座"

还有一些其他的生成随机数据的方法，大家可以直接去官网看下，这里就不一一的描述了。地址：https://github.com/nuysoft/Mo...

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 Schema

template

必选，表示数据模板，可以是对象或者字符串。

关于mock.js的介绍也这么多，这些基本上是根据官文摘抄，但是基本上够我们日常使用。