【mock】手把手带你用mock写自定义接口+mock常用语法

mock自定义接口完整流程

官网语法规范:https://github.com/nuysoft/Mock/wiki/Syntax-Specification

首先: 要有一个项目,我这里是vue3项目,以下从vue3项目搭建开始,已搭建好的请直接看2

1.空目录下新建vue3项目

1. 运行创建项目命令：

在bash中:(文件路径处输入cmd回车进入bash)

# 使用npm
npm create vite@latest
# 使用yarn
yarn create vite
# 使用pnpm
pnpm create vite

1. 输入项目名称，默认是 vite-project

2. 选择前端框架

3. 选择项目语言 我这里暂时选的是js,大家看情况选
   

4. 创建完毕

5. 进入项目目录,拖入vscode打开

2. 进入vscode进行相关配置下载

npm /yarn 根据各自语法自行下载

• 打开终端下载依赖

pnpm i

• 下载mockjs

pnpm i mockjs

• 下载axios

pmpn i axios

• 运行程序(package.json可查看项目启动命令)

pnpm run dev

3. mock配置

• 1)创建文件夹src/mock/index.js

• 2)在main.js全局引入

import './mock/index'

• 3)在mock/index.js中引入与测试
  注意这里的 | 两边不能有空格

//引入mock模块
import Mock from "mockjs";
const data = Mock.mock({
    
    
  "string|4": "test", //生成4次
})
console.log(data);

直接在页面控制台可以看到打印了四次test就是Ok了

4. mock模拟接口发送请求

• 在mock/index.js中模拟请求

Mock.mock("/api/get/user",'get',{
    
    
  status: 200,
  message: '获取用户信息数据成功'
})

• 在vue.app或任意vue页面

<template>
  <div>
    这是vue3的框架!
  </div>
</template>
<script setup>
import axios from 'axios'
axios.get('/api/get/user').then(res => {
    
    
  console.log(res);
})
</script>
<style>
</style>

• 在页面的控制台可以看到获取成功

5. mock模拟数据发送请求(模拟简单用户信息列表)

// 准备数据
const data = Mock.mock({
    
    
  "list|10-20": [
    {
    
    
      id: "@word(10)", 
      name: "@cname",
      address: "@city(true)", 
    },
  ],
});

Mock.mock("/api/get/new",'get',{
    
    
  status: 200,
  message: '获取用户信息数据成功',
  data:data.list
})

调用

<script setup>
import axios from 'axios';
axios.get('/api/get/new').then(res => {
    
    
  console.log(res);
})
</script>

效果

6. mock模拟数据并实现分页获取数据功能(get)

接口地址：/api/get/news

接口参数：pageindex: 页码
pagesize：每页的条数

请求类型：GET

//引入mock模块
import Mock from "mockjs";
// 定义数据
const data = Mock.mock({
    
    
  'newsList|20-30': [
      {
    
    
          id: '@increment()',
          title: '@ctitle(10,15)',
          content: '@cparagraph(5,15)',
          img_url: '@image("100x100","#FFE4B5","#fff","暂无图片")',
          add_time: '@date(yyyy-MM-dd hh:mm:ss)'
      }
  ]
})

// 定义分页功能
// 获取参数
const getUrlQuery =  (url,name) => {
    
    
  const index = url.indexOf('?')
  if(index>-1){
    
    
      const searchStr = url.substr(index+1)
      const searchArr = searchStr.split('&')
      for(var i=0;i<searchArr.length;i++){
    
    
          const itemArr = searchArr[i].split('=')
          console.log(name,itemArr[0])
          if(name === itemArr[0]){
    
    
              return itemArr[1]
          }
      }
  }
}
// 定义获取新闻列表的接口
Mock.mock(/\/api\/get\/news/,'get',(options) => {
    
    
// 获取页码
const pageindex = getUrlQuery(options.url,'pageindex')
// 获取每页条数
const pagesize = getUrlQuery(options.url,'pagesize')
// 数据总条数
const total = data.newsList.length
// 数据总页数
const totalPage = Math.ceil(total/pagesize)
// 截取的开始位置
const start = (pageindex - 1)*pagesize
// 截取的结束位置
const end = pageindex*pagesize
// 数据截取
const list = pageindex<=totalPage?data.newsList.slice(start,end):[]
return {
    
    
  status: 200,
  message: '获取新闻列表成功',
  list: list,
  total: total
}
})

调用接口获取数据:

// 分页获取数据
axios({
    
    
  url: `/api/get/news`,
  method: 'get',
  params: {
    
    
    pageindex: 1,
    pagesize: 10
  }
}).then(res => {
    
    
  console.log(res);
})

效果:

7. mock模拟数据实现添加数据功能(post)

接口地址：/api/add/news

接口参数：title: 标题
content：内容

请求类型：POST

mock模拟数据:

// 添加
Mock.mock('/api/add/news','post',(options) => {
    
    
  const body = JSON.parse(options.body)
  const {
    
    newsList} = data
  newsList.unshift(Mock.mock({
    
    
      id: '@increment()',
      title: body.title,
      content: body.content,
      img_url: '@image("100x100","#FFE4B5","#fff","暂无图片")',
      add_time: '@date(yyyy-MM-dd hh:mm:ss)'
  }))
  return {
    
    
      status: 200,
      message: '添加成功',
      list: newsList
  }
})

调用接口:

// 新增
axios({
    
    
  url: '/api/add/news',
  method: 'post',
  data: {
    
    
    title: '标题',
    content: '内容'
  }
}).then(res => {
    
    
  console.log(res);
})

效果:

8. mock模拟数据实现删除数据功能(delete)

接口地址：/api/delete/news

接口参数：id: 新闻id

请求类型：POST

mock中:

// 删除接口
Mock.mock('/api/delete/news','delete',(options)=>{
    
    
  var body = JSON.parse(options.body)
  const {
    
    newsList} = data
  const index = newsList.findIndex(item=>{
    
    
      return item.id === body.id
  })
  newsList.splice(index,1)
  return {
    
    
      status: 200,
      message: '删除成功',
      list: newsList
  }
})

调用接口:

//删除
axios({
    
    
  url: '/api/delete/news',
  method: 'delete',
  data: {
    
    
    id: 1
  }
}).then(res => {
    
    
  console.log(res);
})

效果:

9. mock常用语法

(1) 生成字符串

• 生成指定次数字符串

  import Mock from 'mockJs'
  const data = Mock.mock({
        
        
      "string|4": "哎呦！"
  })
  

• 生成指定范围长度字符串

  const data = Mock.mock({
        
        
      "string|1-8": "哎呦！"
  })
  

(2) 生成文本

• 生成一个随机字符串

  const data = Mock.mock({
        
        
      "string": "@cword"
  })
  

• 生成指定长度和范围

  const data = Mock.mock({
        
        
      string: "@cword(1)",
      str: '@cword(10,15)'
  })
  

(3) 生成标题和句子

• 生成标题和句子

  const data = Mock.mock({
        
        
      title: "@ctitle",
      sentence: '@csentence'
  })
  

• 生成指定长度的标题和句子

  const data = Mock.mock({
        
        
      title: "@ctitle(8)",
      sentence: '@csentence(50)'
  })
  

• 生成指定范围的

  const data = Mock.mock({
        
        
      title: "@ctitle(5,8)",
      sentence: '@csentence(50,100)'
  })
  

(4) 生成段落

• 随机生成段落

  const data = Mock.mock({
        
        
      content: '@cparagraph()' 
  })
  

(5) 生成数字

• 生成指定数字

  const data = Mock.mock({
        
        
      "number|80": 1
  })
  

• 生成范围数字

  const data = Mock.mock({
        
        
      "number|1-999": 1
  })
  

(6) 生成增量id

• 随机生成标识

  const data = Mock.mock({
        
        
      id: '@increment()'
  })
  

(7) 生成姓名-地址-身份证号

• 随机生成姓名-地址-身份证号

  const data = Mock.mock({
        
        
      name: '@cname()',
      idCard: '@id()',
      address: '@city(true)'
  })​
  

(8) 随机生成图片

• 生成图片：@image(“300x250”,“#ff0000”,“#fff”,“gif”,“坤坤”)

• 参数1：图片大小

  [
      '300x250', '250x250', '240x400', '336x280', 
      '180x150', '720x300', '468x60', '234x60', 
      '88x31', '120x90', '120x60', '120x240', 
      '125x125', '728x90', '160x600', '120x600', 
      '300x600'
  ]
  

• 参数2：图片背景色

• 参数3：图片前景色

• 参数4：图片格式

• 参数5：图片文字

(9) 生成时间

• @Date
• 生成指定格式时间：@date(yyyy-MM-dd hh:mm:ss)

(10) 指定数组返回的条数

• 指定长度：‘data|5’

• 指定范围：‘data|5-10’

  const data = Mock.mock({
        
        
      'list|50-99':[
          {
        
        
              name: '@cname()',
              address: '@city(true)',
              id: '@increment()'
          }
      ]
  })
  

10. mock拦截请求

见段落4-8

11. 补充：fast-mock

百度搜索fast-mock可以在线搭建接口！很方便！
传送门：https://www.fastmock.site/#/login