mock.js 语法笔记

[guoshuai93]

mock.js 语法笔记

mockjs 以及 easy-mock 深入学习

mock.js 的语法规范包括两部分：

1. 数据模板定义
2. 数据占位符定义

数据模板定义

一个完整的数据模板又包括：属性名、生成规则、属性值。

// 属性名   name
// 生成规则 rule
// 属性值   value
'name|rule': value

注意：

• 属性名 和 生成规则 之间用竖线 | 分隔。
• 生成规则 是可选的。
• 生成规则 有 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
• 生成规则 的 含义 需要依赖 属性值的类型 才能确定。
• 属性值 中可以含有 @占位符。
• 属性值 还指定了最终值的初始值和类型。

例子：

模板
"number|1-100": 100

结果
"number": 16

数据占位符

格式：

@占位符
@占位符(参数 [, 参数])

注意：

1. 用 @ 来标识其后的字符串是 占位符。
2. 占位符 引用的是 Mock.Random 中的方法。
3. 通过 Mock.Random.extend() 来扩展自定义占位符。
4. 占位符 也可以引用 数据模板 中的属性。
5. 占位符 会优先引用 数据模板 中的属性。
6. 占位符 支持 相对路径 和 绝对路径。

语法里涉及到了几乎我们所有经常用到的数据模板，比如：

• Basic
  boolean, natural, integer, float, character, string, range
• Date
  date, time, datetime, now
• Image
  img, dataImage
• Color
  color, hex, rgb, rgba, hsl
• Text
  paragraph, sentence, word, title, cparagraph, csentence, cword, ctitle（带c的会生成中文内容）
• Name
  first, last, name, cfirst, clast, cname
• Web
  url, domain, protocol, tld, email, ip
• Address
  region, province, city, county, zip
• Helper
  capitalize, upper, lower, pick, shuffle
• Miscellaneous
  guid, id, increment

例子：

{
  "list|2": [{
    "title": "@ctitle(15,25)",
    "author": "@cname",
    "id": "@id",
    "display_time": "@date(yyyy-MM-dd)",
    "status|1": ["draft", "published", "deleted"],
    "pageviews": "@integer(1000, 3000)"
  }]
}
// 生成后的数据
{
  "list": [
    {
      "title": "想好少内段验下矿飞内造件划候被数头元眼何性时象",
      "author": "武勇",
      "id": "640000199006222588",
      "display_time": "1993-06-16",
      "status": "deleted",
      "pageviews": 1494
    },
    {
      "title": "天员般我律手着目如安四世算是毛教",
      "author": "雷敏",
      "id": "610000200405158763",
      "display_time": "2006-07-17",
      "status": "published",
      "pageviews": 1448
    }
  ]
}

官方文档：

• mock.js--官网
• mock.js--wiki
• easy-mock