[JavaScript知识库]在react中使用mockjs

介绍

mock意为“模仿”或"模拟"，简单来说，就是造数据，造你想要的几乎任何数据，包括api和通过api返回的数据。

在写完项目进行自测，或者写页面需要数据 但是又不想单独开个后端，这时候就可以用mockjs来实现返回随机数据。

官网：http://mockjs.com/

官方文档：https://github.com/nuysoft/Mock/wiki

示例文档：http://mockjs.com/examples.html

安装 & 卸载 & 引入

// 安装
npm i mockjs

// 卸载
npm uninstall mockjs

// 项目中引入
import Mock from 'mockjs'

基础语法 & 规范

Mock.mock

造数据，需要使用到mock方法：

Mock.mock(xxx)

// 这里面的xxx就是要通过mock来模拟的数据

每个被伪造的数据，都包含3部分：

• 属性名 name
• 生成规则 rule
• 属性值 value

比如：

const data = Mock.mock({
    code: '0',
    msg: 'success',
    'list|5': [{ name: '@name', age: '@integer(18, 25)'}]
})

这里的code , msg , list 都是属性名，其中list和msg都是字符串，list是数组

code和msg的数据过于简单，所以生成规则在这里省略了，

而list对应的生成规则是|5，意思是生成一个数组，里面包含5个元素

这里的'0' , 'success' 和 [{ name: '@name', age: '@integer(18, 25)'}]就是他们各自对应的值。

打印一下生成的结果看看：

console.log(data)
/*********结果如下*************/
{
    "code": "0",
    "msg": "success",
    "list": [
        {
            "name": "Nancy Lewis",
            "age": 18
        },
        {
            "name": "Gary Wilson",
            "age": 25
        },
        {
            "name": "Shirley Gonzalez",
            "age": 22
        },
        {
            "name": "Mark Moore",
            "age": 24
        },
        {
            "name": "Richard Gonzalez",
            "age": 22
        }
    ]
}

// 另外，多次打印可以看出，每次结果都是不一样的，数据是随机的。

从上面的例子可以得知，生成规则是可选的，非必须的

如果存在生成规则，那么属性名和生成规则之间需要用|隔开

7种生成规则

• 'name|min-max': value

// 表示value值重复的次数，最少min次，最多max次
const data = Mock.mock({
    'list|1-5': ['hello-']
})

// 得到的结果可能是：
[
    "hello-",
    "hello-",
    "hello-",
    "hello-",
    "hello-"
]
// 也可能是：
[
    "hello-",
    "hello-",
    "hello-"
]

// hello-随机重复1-5次作为结果

• 'name|count': value

// value固定重复count次
const data = Mock.mock({
    'list|2': ['hello-']
})
// 得到的结果是：
[
    "hello-",
    "hello-"
]

• 'name|min-max.dmin-dmax': value

// 当value 是数字型时，生成一个浮点数，
// 浮点数的整数部分大于等于 min、小于等于 max，小数部分保留 dmin 到 dmax 位。
// 生成的值和初始写的value值的大小无关，value的初始值只是用来确定数据类型
const data = Mock.mock({
    'num1|1-100.1-3': 1
})

生成的结果可能是：

也可能是：

• 'name|min-max.dcount': value

// 当value 是数字型时，生成一个浮点数，
// 浮点数的整数部分大于等于 min、小于等于 max，小数部分保留dcount位。
// 生成的值和初始写的value值的大小无关，value的初始值只是用来确定数据类型

• 'name|count.dmin-dmax': value

// 当value 是数字型时，生成一个浮点数，
// 浮点数的整数部分等于count，小数部分保留 dmin 到 dmax 位。
// 生成的值和初始写的value值的大小无关，value的初始值只是用来确定数据类型

• 'name|count.dcount': value

// 当value 是数字型时，生成一个浮点数，
// 浮点数的整数部分是count，小数部分保留dcount位。
// 生成的值和初始写的value值的大小无关，value的初始值只是用来确定数据类型

• 'name|+step': value

// 当value为数字时，初始值为value，每次得到的结果会自增1

生成规则和属性值value的关系

属性值是布尔值

'name|1': value
// 当value是true或者false时
// 最终结果会返回一个布尔值，返回true的概率是1/2，返回false的概率也是1/2

'name|min-max': value
// 当value是一个表示布尔值的结果时，
// 会随机生成一个布尔值，值为 value 的概率是 min / (min + max)，
// 值为 !value 的概率是 max / (min + max)

属性值是对象 Object

'name|count': object
// 从属性值 object 中随机选取 count 个属性

'name|min-max': object
// 从属性值 object 中随机选取 min 到 max 个属性

属性值是数组 Array

'name|1': array

// 从属性值 array 中随机选取 1 个元素，作为最终值。

'name|+1': array

// 从属性值 array 中顺序选取 1 个元素，作为最终值。

'name|min-max': array

// 通过重复属性值 array 生成一个新数组，重复次数大于等于 min，小于等于 max。

// 'name|count': array

通过重复属性值 array 生成一个新数组，重复次数为 count。

属性值是正则表达式 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"
}

占位符@

占位符 引用的是 Mock.Random 中的方法，

这跟vue中的v-on:click省略成@click很像。可以简单理解为Mock.Random的缩写。

@后面跟上Mock.Random的一些固定方法，用来生成随机数据。

用法示例：

// 比如我们现在要随机生成一个中文人名
const data = Mock.Random.cname()
// 结果：
// data: 赵丽

改成占位符的方法就是：

const data = Mock.mock('@cname')
// 结果：
// data:  张秀兰

这里的cname就是Mock.Random的一个方法，表示获取随机的中文人名。

这里有一张表格，包含了Mock.Random的方法，并进行了简单的分类：

方法名前面带c的，都是用来获取中文相关的数据的。比如@name用来生成随机的英文名，而@cname就是用来生成随机的中文名。

另外，这些方法还可以带参数，以下有一些例子：

import Mock from 'mockjs'

let basicData = Mock.mock({
    'list|1-100': [{
        'id|+1': 1,
        'isBoolean': '@boolean(10, 0, true)',//百分之百的true
        'naturalNumber': '@natural(1, 1000)', //大于等于零的整数
        'integer': '@integer(0)', //随机整数
        'float': '@float(1, 100, 3, 6)', //随机浮点数, 
        'character': '@character("upper")', //一个随机字符
        'string': '@string("lower", 5, 20)', //一串随机字符串
        'range': '@range(1, 10, 2)', //一个整形数组，步长为2
    }]
});

// console.log(basicData);

let Date = Mock.mock({
    'dateList|10': [{
        'date': '@date',
        'date-yyyy-MM-dd': '@date(yyyy-MM-dd)',
        'date-yy-MM-dd': '@date(yy-MM-dd)',
        'date-y-MM-dd': '@date(y-MM-dd)',
        'date-y-M-d': '@date(y-M-d)',
        'line-through': '------------------------------------------------',
        'timessss': '@time', //随机的时间字符串,
        'time-format': '@time()', //指示生成的时间字符串的格式, default: 'HH: mm: ss',
        'time-format-1': '@time("A HH:mm:ss")',
        'time-format-2': '@time("a HH:mm:ss")',
        'time-format-3': '@time("HH:mm:ss")',
        'time-format-4': '@time("H:m:s")',
        'datetime': '@datetime("yyyy-MM-dd A HH:mm:ss")', //返回一个随机的日期和时间字符串
        'dateNow': '@now("second")' //获取当前完整时间
    }]
});
// console.log(Date);

let imageList = Mock.mock({
    'imageList|5': [{
        'id|+1': 1,
        'img': '@image',//生成一个随机的图片地址,
        'img-1': '@image("200x100", "#000", "#fff", "png", "Mock.js")', //生成一个200*100, 背景色#000，前景色#fff, 格式png, 文字mock.js的图片
    }]
})
// console.log(imageList);

let paragraph = Mock.mock({
    'paragraphList|5': [{
        'id|+1': 1,
        'paragraph1': '@cparagraph(2)', //生成一段2句话的中文文本,
        'paragraph2': '@paragraph(3)', //生成一个3句话的英文文本
        'title': '@title', //随机生成一个英文标题
        'ctitle': '@ctitle', //随机生成一个中文标题
    }]
})
// console.log(paragraph);

let name = Mock.mock({
    'nameList|5': [{
        'id|+1': 1,
        'name': '@name', //英文名,
        'cname': '@cname', //中文名
    }]
})
// console.log(name);

let webList = Mock.mock({
    'webList|5': [{
        'id|+1': 0,
        'url': '@url("http", "baidu.com")', //url: http://www.baidu.com
        'protocol': '@protocol', //随机生成一个url协议
        'domain': '@domain', //随机生成一个域名,
        'email': '@email', //随机生成一个邮箱地址,
        'ip': '@ip' //随机生成一个ip地址
    }]
})
// console.log(webList);

let address = Mock.mock({
    'addressList|5': [{
        'id|+1': 1,
        'region': '@region', //生成一个大区
        'province': '@province', //生成一个省份
        'city': '@city', //生成一个市
        'country': '@country', //一个县
        'zip': '@zip', //邮政编码
    }]
})
console.log(address)

此外，有完整的官方示例文档：http://mockjs.com/examples.html

哪个方法不知道怎么用了， 就可以直接去示例文档中查看。

模拟接口

Mock.mock( rurl, rtype, data)

介绍以下三个参数：

• rurl：请求路径，可以是相对路径，也可以是绝对路径
• rtype：请求方式，比如get post put delete等
• data：要返回的模拟数据

举例：

import React, {useEffect} from 'react'
import Mock from 'mockjs'
import axios from 'axios'

Mock.mock('/mock/usermsg', 'get', {
    code: '0',
    msg: 'success',
    'list|5': [{ name: '@name', age: '@integer(18, 25)'}]
})

const DemoMock = () => {
    useEffect(async () => {
        const res = await axios('/mock/usermsg')
        console.log(res.data)
    })
    return <h3>hello react</h3>
}

export default DemoMock

返回的结果：

是不是很好玩？