生成规则和示例：
1. 属性值是字符串 String
-
'name|min-max': string通过重复
string生成一个字符串，重复次数大于等于min，小于等于max。
Mock.mock({
"string|1-10": "★"
})
// =>
{
"string": "★★★★★"
}
-
'name|count': string通过重复
string生成一个字符串，重复次数等于count。
2. 属性值是数字 Number
-
'name|+1': number属性值自动加 1，初始值为
number。 -
'name|min-max': number生成一个大于等于
min、小于等于max的整数，属性值number只是用来确定类型。 -
'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,
'number5|0.2': 1
})
// =>
{
"number1": 12.92,
"number2": 123.51,
"number3": 123.777,
"number4": 123.1231091814,
"number5": 0.47
}
3. 属性值是布尔型 Boolean
-
'name|1': boolean随机生成一个布尔值，值为 true 的概率是 1/2，值为 false 的概率同样是 1/2。
Mock.mock({
"boolean|1": true
})
// =>
{
"boolean": true
}
-
'name|min-max': value随机生成一个布尔值，值为
value的概率是min / (min + max)，值为!value的概率是max / (min + max)。
Mock.mock({
"boolean|1-2": true
})
// =>
{
"boolean": true
}
4. 属性值是对象 Object
-
'name|count': object从属性值
object中随机选取count个属性。
Mock.mock({
"object|3": {
"310000": "上海市",
"320000": "江苏省",
"330000": "浙江省",
"340000": "安徽省"
}
})
// =>
{
"object": {
"320000": "江苏省",
"310000": "上海市",
"330000": "浙江省"
}
}
-
'name|min-max': object从属性值
object中随机选取min到max个属性。
Mock.mock({
"object|2-4": {
"110000": "北京市",
"120000": "天津市",
"130000": "河北省",
"140000": "山西省"
}
// =>
{
"object": {
"110000": "北京市",
"130000": "河北省"
}
}
})
5. 属性值是数组 Array
-
'name|1': array从属性值
array中随机选取 1 个元素，作为最终值。
Mock.mock({
"array|1": [
"AMD",
"CMD",
"UMD"
]
})
// =>
{
"array": "AMD"
}
-
'name|+1': array从属性值
array中顺序选取 1 个元素，作为最终值。 -
'name|min-max': array通过重复属性值
array生成一个新数组，重复次数大于等于min，小于等于max。 -
'name|count': array通过重复属性值
array生成一个新数组，重复次数为count。
Mock.mock({
"array|1-10": [
{
"name|+1": [
"Hello",
"Mock.js",
"!"
]
}
]
})
// =>
{
"array": [
{
"name": "Hello"
},
{
"name": "Mock.js"
},
{
"name": "!"
}
]
}
6. 属性值是函数 Function
-
'name': function执行函数
function，取其返回值作为最终的属性值，函数的上下文为属性'name'所在的对象。
Mock.mock({
'foo': 'Syntax Demo',
'name': function() {
return this.foo
}
})
// =>
{
"foo": "Syntax Demo",
"name": "Syntax Demo"
}
7. 属性值是正则表达式 RegExp
-
'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" }
8. DEMO
-
'name': 占位// Random.natural( min, max ) Mock.mock('@natural(60, 100)') => 74 // Random.integer( min?, max? ) Mock.mock('@integer(60, 100)') => 96 // Random.float( min?, max?, dmin?, dmax? ) Mock.mock('@float(60, 100, 3, 5)') => 80.88266 | 80.882 | 80.8826 // Random.string( pool?, min?, max? ) Mock.mock('@string("lower", 1, 3)') => "x" Mock.mock('@string("upper", 1, 3)') => "JBR" Mock.mock('@string("number", 1, 3)') => "84" Mock.mock('@string("symbol", 1, 3)') => "[#" Mock.mock('@string("aeiou", 1, 3)') => "ii" // Random.range(start?, stop, step?) Mock.mock('@range(1, 10, 2)') => [1,3,5,7,9] Mock.mock('@range(1, 10, 3)') => [1,4,7] // Random.date( format? ) Mock.mock('@date("yyyy-MM-dd")') => "2008-11-05" Mock.mock('@date("yy-MM-dd")') => "96-07-29" Mock.mock('@date("y-MM-dd")') => "14-03-11" Mock.mock('@date("y-M-d")') => "08-6-1" Mock.mock('@date("yyyy yy y MM M dd d")') => "1976 76 76 03 3 22 22" // Random.time( format? ) Mock.mock('@time("A HH:mm:ss")') => "PM 16:05:39" Mock.mock('@time("a HH:mm:ss")') => "pm 12:56:23" Mock.mock('@time("HH:mm:ss")') => "00:43:23" Mock.mock('@time("H:m:s")') => "13:44:0" Mock.mock('@datetime("HH H hh h mm m ss s SS S A a T")') => "06 6 06 6 44 44 45 45 103 103 AM am 1473374685103" // Random.datetime( format? ) Mock.mock('@datetime("y-MM-dd HH:mm:ss")') => "86-12-03 19:29:05" Mock.mock('@datetime("y-M-d H:m:s")') => "02-9-19 21:50:38" // Random.now( unit?, format? ) Mock.mock('@now()') => "2025-01-08 08:45:59" Random.now('day', 'yyyy-MM-dd HH:mm:ss SS') => "2025-01-08 00:00:00 000" // Random.image( size?, background?, foreground?, format?, text? ) Random.image('200x100', '#894FC4', '#FFF', 'png', '!') => // Random.rgba() Mock.mock('@rgba()') => "rgba(174, 121, 242, 0.30)" // Random.word( min?, max? ) Mock.mock('@word(3, 5)') => "vxfg" | "vxf" | "vxfgd" // Random.ctitle( min?, max? ) Mock.mock('@ctitle(3, 5)') => "要事所片" // Random.cname() Mock.mock('@cname()') => "罗秀兰" // Random.url() Mock.mock('@url()') => "ftp://dhfdx.nf/tiuql" // Random.domain() Mock.mock('@domain()') => "qxkiqmif.nf" // Random.id() Mock.mock('@id()') => "520000198408228147" // Random.increment( step? ) Mock.mock('@increment(1000)') => 2203
数据占位符定义规范 DPD
占位符 只是在属性值字符串中占个位置，并不出现在最终的属性值中。
占位符 的格式为：
@占位符
@占位符(参数 [, 参数])
注意：
- 用
@来标识其后的字符串是 占位符。 -
占位符 引用的是
Mock.Random中的方法。 - 通过
Mock.Random.extend()来扩展自定义占位符。 - 占位符 也可以引用 数据模板 中的属性。
- 占位符 会优先引用 数据模板 中的属性。
- 占位符 支持 相对路径 和 绝对路径。
Mock.mock({
name: {
first: '@FIRST',
middle: '@FIRST',
last: '@LAST',
full: '@first @middle @last'
}
})
// =>
{
"name": {
"first": "Charles",
"middle": "Brenda",
"last": "Lopez",
"full": "Charles Brenda Lopez"
}
}
