mockjs(3)

mockjs（1）
mockjs（2）

这篇主要是Mock.random工具类，前段要用的话主要是在模版中的占位符。mockjs（1）里面的3.2

6 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" }

可以在上面的例子中看到，直接调用'Random.email()'时方法名email()是小写的，而数据模板中的@EMAIL却是大写。
并不是说对数据模板中的占位符做了什么特殊处理，也并不是说在模版里面必须这么写，在数据模板中用小写的 @email 也可以达到同样的效果。
官方建议在模板里面占位符的部分用大写，目的是更好区分占位符和普通字符

在浏览器中，为了减少需要拼写的字符，Mock.js 把 Mock.Random 暴露给了 window 对象，使之成为全局变量，从而可以直接访问 Random。因此上面例子中的 var Random = Mock.Random; 可以省略。在后面的例子中，也将做同样的处理。

在 Node.js 中，仍然需要通过Mock.Random访问。

Type	Method
Basics	boolean, natural, integer, float, character, string, range, date, time, datetime, now
Image	image, dataImage
Color	color
Text	paragraph, sentence, word, title
Name	first, last, name
Web	url, domain, email, ip, tld
Address	area, region
Helpers	capitalize, upper, lower, pick, shuffle
Miscellaneous	guid, id

6.1 Basics

6.1.1 Random.boolean(min, max, cur)

Random.boolean()
Random.boolean(min, max, cur)

返回一个随机的布尔值。

参数及默认值如下：

• min：可选。指参数 cur 出现的概率。概率计算公式为 min / (min + max)。该参数的默认值为 1，即有 50% 的概率返回参数 cur。
• max：可选。指参数 cur 的相反值（!cur）出现的概率。概率计算公式为 max / (min + max)。该参数的默认值为 1，即有 50% 的概率返回参数 cur。
• cur：可选。可选值为布尔值 true 或 false。如果未传入任何参数，则返回 true 和 false 的概率各为 50%。该参数没有默认值，在该方法的内部，依据原生方法 Math.random() 返回的（浮点）数来计算和返回布尔值，例如在最简单的情况下，返回值是表达式 Math.random() >= 0.5 的执行结果。

使用示例如下所示：

Random.boolean()//true/false各占50%概率
// => true
Random.boolean(1, 9, true)//min:1;max:9;cur:true.意为随机出true的概率为10%（1/1+9=10%）
// => false
Random.bool()
// => false
Random.bool(1, 9, false)
// => true

占位符用法

'isEdit':'@BOOLEAN'//true/false各占50%概率
//=> true
'isEdit':'@BOOLEAN(1,9,true)'//min:1;max:9;cur:true.意为随机出true的概率为10%（1/1+9=10%）
//=>false
'isEdit':'@BOOL'
'isEdit':'@BOOL(1,9,true)'

6.1.2 Random.natural(min, max)

• Random.natural()
• Random.natural(min)
• Random.natural(min, max)

返回一个随机的自然数（大于等于 0 的整数）。

参数及默认值如下：

• min：可选。指随机自然数的最小值。默认值为 0。
• max：可选。指随机自然数的最大值。默认值为 9007199254740992。

使用示例：

Random.natural()//随机出一个随机数 默认范围0-9007199254740992
// => 1002794054057984
Random.natural(10000)//随机出一个自然数 范围是10000-9007199254740992
// => 71529071126209
Random.natural(60, 100)//随机出一个自然数，范围是60-100
// => 77

占位符用法

'num':'@NATURAL'
//=> 1002794054057984
'num':'@NATURAL(10000)'
//=> 71529071126209
'num':'@NATURAL(60-100)'
//=> 80

6.1.3 Random.integer(min, max)

• Random.integer()
• Random.integer(min)
• Random.integer(min, max)

返回一个随机的整数。

含义和默认值如下：

• min：可选。指随机整数的最小值。默认值为 -9007199254740992。
• max：可选。指随机整数的最大值。默认值为 9007199254740992。

示例如下：

Random.integer()//随机整数 范围为 -9007199254740992到9007199254740992
// => -3815311811805184
Random.integer(10000)//随机整数 范围是 10000到9007199254740992
// => 4303764511003750
Random.integer(60,100)//随机整数 范围是60到100
// => 96

占位符用法，不过随机生成整数还可以用模板写法'intNum |60-100':1

'intNum':'@INTEGER'
//=>  -3815311811805184
'intNum':'@INTEGER(10000)'
//=>  4303764511003750
'intNum':'@INTEGER(60-100)'
//=> 96

6.1.4 Random.float(min, max, dmin, dmax)

• Random.float()
• Random.float(min)
• Random.float(min, max)
• Random.float(min, max, dmin)
• Random.float(min, max, dmin, dmax)

返回一个随机的浮点数。

参数和默认值如下：

• min：可选。整数部分的最小值。默认值为 -9007199254740992。
• max：可选。整数部分的最大值。默认值为 9007199254740992。
• dmin：可选。小数部分位数的最小值。默认值为 0。
• dmax：可选。小数部分位数的最大值。默认值为 17。

示例如下：

Random.float()//随机浮点数  范围是 -9007199254740992到9007199254740992，小数部分位数是0-17位
// => -1766114241544192.8
Random.float(0)//随机浮点数 范围是0到9007199254740992，小数部分位数是0-17位
// => 556530504040448.25
Random.float(60, 100)//随机浮点数 范围是60到100，小数部分位数是0-17位
// => 82.56779679549358
Random.float(60, 100, 3)//随机浮点数 范围是60到100，小数部分位数是3-17位
// => 61.718533677927894
Random.float(60, 100, 3, 5)//随机浮点数 范围是60到100，小数部分位数是3-5位
// => 70.6849

占位符用法，不过随机浮点数也可以用模板写法'floatNum|60-100.3-5':1

'floatNum':'@FLOAT()'
// => -1766114241544192.8
'floatNum':'@FLOAT(0)'
// => 556530504040448.25
'floatNum':'@FLOAT(60,100)'
// => 82.56779679549358
'floatNum':'@FLOAT(60,100,3)'
// => 61.718533677927894
'floatNum':'@FLOAT(60,100,3,5)'
// => 70.6849

6.1.5 Random.character(pool)

返回一个随机字符。

• Random.character()
• Random.character('lower/upper/number/symbol')
• Random.character(pool)

参数及默认值如下：

• pool：可选。字符串。表示字符池，将从中选择一个字符返回。

  • 如果传入 'lower' 或 'upper'、'number'、'symbol'，表示从内置的字符池从选取
  • 如果未传入该参数，则从'lower' + 'upper' + 'number' + 'symbol'中随机选取一个字符返回。

字符池如下：

{
     lower: "abcdefghijklmnopqrstuvwxyz",
     upper: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
     number: "0123456789",
     symbol: "!@#$%^&*()[]"
}

示例如下：

Random.character()//随机字符 从内置字符池随机选取
// => "P"
Random.character('lower')//随机小写字符   
// => "y"
Random.character('upper')//随机大写字符
// => "X"
Random.character('number')//随机数字
// => "1"
Random.character('symbol')//随机符号
// => "&"
Random.character('aeiou')//从aeiou中随机一个
// => "u"

占位符用法，模板写法也可以是'charRandom|1':['a','e','i','o','u']

'charRandom':'@CHARACTER'
// => "P"
'charRandom':"@CHARACTER('lower')"
// => "y"
'charRandom':"@CHARACTER('upper')"
// => "X"
'charRandom':"@CHARACTER(number)"
// => "1"
'charRandom':"@CHARACTER('symbol')"
// => "&"
'charRandom':"@CHARACTER('aeiou')"
// => "u"

6.1.6 Random.string(pool, min, max)

返回一个随机字符串。

• Random.string()
• Random.string( length )
• Random.string( pool, length )
• Random.string( min, max )
• Random.string( pool, min, max )

参数及默认值如下：

• pool：可选。字符串。表示字符池，将从中选择一个字符返回。这部分跟Random.character(pool)一样
• min：可选。随机字符串的最小长度。默认值为 3。
• max：可选。随机字符串的最大长度。默认值为 7。

示例如下：

Random.string()//随机字符串 长度是3-7位
// => "pJjDUe"
Random.string( 5 )//随机字符串 长度是5
// => "GaadY"
Random.string( 'lower', 5 )//随机小写字符串 长度是5
// => "jseqj"
Random.string( 7, 10 )//随机字符串 长度是7-10
// => "UuGQgSYk"
Random.string( 'aeiou', 1, 3 )//从 aeiou 中随机字符串，长度是1-3 
// => "ea"

占位符用法

'destription':'@STRING'
// => "pJjDUe"
'destription':"@STRING(5)"
// => "GaadY"
'destription':"@STRING('lower',5)"
// => "jseqj"
'destription':"@STRING(7,10)"
// => "UuGQgSYk"
'destription':"@STRING('aeiou',1,3)"
// => "ea"

6.1.7 Random.range(start, stop, step)

• Random.range(stop)
• Random.range(start, stop)
• Random.range(start, stop, step)

返回一个整型数组。

参数及默认值如下：

• start：必选。数组中整数的起始值。
• stop：可选。数组中整数的结束值（不包含在返回值中）。
• step：可选。数组中整数之间的步长。默认值为 1。

示例如下：

Random.range(10)
// => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
Random.range(3, 7)//数组中整数从3开始到7
// => [3, 4, 5, 6]
Random.range(1, 10, 2)//数组中整数从1开始到10结束步长为2
// => [1, 3, 5, 7, 9]
Random.range(1, 10, 3)//数组中整数从1开始到10结束步长为3
// => [1, 4, 7]

6.1.8 Random.date(format)

• Random.date()
• Random.date(format)

返回一个随机的日期字符串。

参数及默认值如下：

• format：可选。指示生成的日期字符串的格式。默认值为 yyyy-MM-dd。

可选的占位符参考自 Ext.Date，如下所示：

Format	Description	Example
yyyy	年份的完整数字表示，4位数字	1999 or 2003
yy	年份的两位数表示	99 or 03
y	A two digit representation of a year	99 or 03
MM	月份的数字表示形式，前导零	01 to 12
M	月份的数字表示形式，不带前导零	1 to 12
dd	月份的日期，2位前导零的数字	01 to 31
d	月份的日期，没有前导0	1 to 31
HH	带前导零的小时的24小时格式	00 to 23
H	不带前导零的小时的24小时格式	0 to 23
hh	带前导零的小时的12小时格式	01 to 12
h	不带前导零的小时的12小时格式	1 to 12
mm	有前导零的分钟表示	00 to 59
m	没有前导零的分钟表示	0 to 59
ss	有前导零的秒表示	00 to 59
s	没有前导零的秒表示	0 to 59
SS	有前导零的毫秒表示	000 to 999
S	没有前导零的毫秒表示	0 to 999
A	大写的AM或PM	AM or PM
a	小写的am或pm	am or pm
T	从 1970-1-1 00:00:00 UTC记法开始到当前的毫秒就是时间戳	759883437303

使用示例如下所示：

Random.date()
// => "2002-10-23"
Random.date('yyyy-MM-dd')
// => "1983-01-29"
Random.date('yy-MM-dd')
// => "79-02-14"
Random.date('y-MM-dd')
// => "81-05-17"
Random.date('y-M-d')
// => "84-6-5"

占位符用法

date: '@DATE'
// => "2002-10-23"
date:"@DATE('yyyy-MM-dd')"
// => "1983-01-29"
date:"@DATE('yy-MM-dd')"
// => "79-02-14"
date:"@DATE('y-MM-dd')"
// => "81-05-17"
date:"@DATE('y-M-dd')"
// => "84-6-5"

6.1.9 Random.time(format)

• Random.time()
• Random.time(format)
  返回一个随机的时间字符串。

参数及默认值如下：

• format：可选。指示生成的时间字符串的格式。默认值为 HH:mm:ss。

可选的占位符参考自 Ext.Date，请参见 Random.date(format)。
示例如下：

Random.time()
// => "00:14:47"
Random.time('A HH:mm:ss')
// => "PM 20:47:37"
Random.time('a HH:mm:ss')
// => "pm 17:40:00"
Random.time('HH:mm:ss')
// => "03:57:53"
Random.time('H:m:s')
// => "3:5:13"

占位符用法

time: '@TIME'
// => "00:14:47"
time: "@TIME('A HH:mm:ss')"
// => "PM 20:47:37"
time: "@TIME('a HH:mm:ss')"
// => "pm 17:40:00"
time: "@TIME('HH:mm:ss')"
// => "03:57:53"
time: "@TIME('H:m:s')"
// => "3:5:13"

6.1.10 Random.datetime(format)

• Random.datetime()
• Random.datetime(format)

返回一个随机的日期和时间字符串。

参数及默认值如下：

• format：可选。指示生成的日期和时间字符串的格式。默认值为 yyyy-MM-dd HH:mm:ss。

可选的占位符参考自 Ext.Date，请参见 Random.date(format)。

示例如下：

Random.datetime()
// => "1977-11-17 03:50:15"
Random.datetime('yyyy-MM-dd A HH:mm:ss')
// => "1976-04-24 AM 03:48:25"
Random.datetime('yy-MM-dd a HH:mm:ss')
// => "73-01-18 pm 22:12:32"
Random.datetime('y-MM-dd HH:mm:ss')
// => "79-06-24 04:45:16"
Random.datetime('y-M-d H:m:s')
// => "02-4-23 2:49:40"

占位符用法

datetime: '@DATETIME'
// => "1977-11-17 03:50:15"
datetime: '@DATETIME("yyyy-MM-dd A HH:mm:ss")'
// => "1976-04-24 AM 03:48:25"
datetime: '@DATETIME("yy-MM-dd a HH:mm:ss")'
// => "73-01-18 pm 22:12:32"
datetime: '@DATETIME("y-MM-dd HH:mm:ss")'
// => "79-06-24 04:45:16"
datetime: '@DATETIME("y-M-d H:m:s")'
// => "02-4-23 2:49:40"

6.1.11 Random.now(unit, format)

• Ranndom.now(unit, format)
• Ranndom.now()
• Ranndom.now(format)
• Ranndom.now(unit)

返回当前的日期和时间字符串。

参数及默认值如下：

• unit：可选。表示时间单元，用于对当前日期和时间进行格式化。可选值有：year、month、week、day、hour、minute、second、week，默认不会格式化。
• format：可选。指生成的日期和时间字符串的格式。默认值为 yyyy-MM-dd HH:mm:ss。同 Random.date(format)。

Random.now() 的实现参考了 Moment.js。

示例如下：

Random.now()
// => "2014-04-29 20:08:38 "
Random.now('day', 'yyyy-MM-dd HH:mm:ss SS')
// => "2014-04-29 00:00:00 000"
Random.now('day')
// => "2014-04-29 00:00:00 "
Random.now('yyyy-MM-dd HH:mm:ss SS')
// => "2014-04-29 20:08:38 157"

Random.now('year')
// => "2014-01-01 00:00:00"
Random.now('month')
// => "2014-04-01 00:00:00"
Random.now('week')
// => "2014-04-27 00:00:00"
Random.now('day')
// => "2014-04-29 00:00:00"
Random.now('hour')
// => "2014-04-29 20:00:00"
Random.now('minute')
// => "2014-04-29 20:08:00"
Random.now('second')
// => "2014-04-29 20:08:38" 

占位符用法

now:"@NOW"
// => "2014-04-29 20:08:38 "
now:"@NOW('day', 'yyyy-MM-dd HH:mm:ss SS')"
// => "2014-04-29 00:00:00 000"
now:"@NOW('day')"
// => "2014-04-29 00:00:00 "
now:"@NOW('yyyy-MM-dd HH:mm:ss SS')"
// => "2014-04-29 20:08:38 157"

now:"@NOW('year')"
// => "2014-01-01 00:00:00"
now:"@NOW('month')"
// => "2014-04-01 00:00:00"
now:"@NOW('week')"
// => "2014-04-27 00:00:00"
now:"@NOW('day')"
// => "2014-04-29 00:00:00"
now:"@NOW('hour')"
// => "2014-04-29 20:00:00"
now:"@NOW('minute')"
// => "2014-04-29 20:08:00"
now:"@NOW('second')"
// => "2014-04-29 20:08:38" 

6.2 Image

6.2.1 Random.image(size, background, foreground, format, text)

• Random.image()
• Random.image(size)
• Random.image(size, background)
• Random.image(size, background, text)
• Random.image(size, background, foreground, text)
• Random.image(size, background, foreground, format, text)

生成一个随机的图片地址。

Random.image() 用于生成高度自定义的图片地址，一般情况下，应该使用更简单的 Random.dataImage()。

参数及默认值如下：

• size：可选。指示图片的宽高，格式为 ‘宽x高’。默认从下面的数组中随机读取一个：

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

• background：可选。指示图片的背景色。默认值为 '#000000'。

• foreground：可选。指示图片的前景色（文件）。默认值为 '#FFFFFF'。

• format：可选。指示图片的格式。默认值为 'png'，可选值包括：'png'、'gif'、'jpg'。

• text：可选。指示图片上的文字。默认为参数 size。

示例如下：

Random.image()
// => "http://dummyimage.com/125x125"
Random.image('200x100')
// => "http://dummyimage.com/200x100"
Random.image('200x100', '#fb0a2a')
// => "http://dummyimage.com/200x100/fb0a2a"
Random.image('200x100', '#02adea', 'Hello')
// => "http://dummyimage.com/200x100/02adea&text=Hello"
Random.image('200x100', '#00405d', '#FFF', 'Mock.js')
// => "http://dummyimage.com/200x100/00405d/FFF&text=Mock.js"
Random.image('200x100', '#ffcc33', '#FFF', 'png', '!')
// => "http://dummyimage.com/200x100/ffcc33/FFF.png&text=!"

生成结果如图

6.2.2 Random.dataImage(size, text)

• Random.dataImage()
• Random.dataImage(size)
• Random.dataImage(size, text)

生成一段随机的 Base64 图片编码。

如果需要生成高度自定义的图片，请使用 Random.image()。

参数及默认值如下：

• size：可选。指示图片的宽高，格式为 ‘宽x高’。默认从下面的数组中随机读取一个：

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

• text：可选。指示图片上的文字。默认为参数 size。

图片的背景色是随机的，取值范围参考自 http://brandcolors.net/。

示例如下：

Random.dataImage()
// => "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAH0AAAB9CAYAAACPgGwlAAAFJElEQVR4Xu2dS0hUURzG/1Yqlj2otJe10AqCoiJaFFTUpgcUhLaKCIogKCEiCl0U1SIIF1EIQlFEtCmkpbWSHlAQYRYUlI9Ie6nYmI9hfIx1LpzL3PGO/aeuM/r/f7PRufe7d873/ea75xw3ZjTumDtMeKlKIAPQVfF2zAK6PuaArpA5oAO6xgQUesacDugKE1BoGU0HdIUJKLSMpgO6wgQUWkbTAV1hAgoto+mArjABhZbRdEBXmIBCy2g6oCtMQKFlNB3QFSag0DKaDugKE1BoGU0HdIUJKLSMpgO6wgQUWkbTAV1hAgoto+mArjABhZbRdEBXmIBCy2g6oCtMQKFlNB3QFSag0DKaDugKE1BoGU0HdIUJKLSMpgO6wgQUWkbTAV1hAgoto+mArjABhZbRdEBXmIBCy2g6oCtMQKFlNB3QFSag0DKaDugKE1BoGU0HdIUJKLQ8bpo+fft+ylxYSJ23LvpisOfNST/N7ENniYa9/0xy4GsTdT+6+09Yx9t4/slEgovSDt2EO3P3YcoqWuUMsWln3oihFlTWUlbhSvf4UKid2iqOUfhVrXussKZ9xHXh10/oW1lxUnmNt/EkNXimOK3QTTtn7Sv1DDUees66rTT/3B0a/NFCvc9raOqf9+YL0PfiIX0/f8ADPdrXTZEPde6xyMd66rx5wXlvnwThN8/cL4ttc7S3i0L3rjqaVI2HyWdMZGmFbhwtvv7cgZm7ZS9NyS/wbboBb1ttwQy2tdLng2s90OOPxSa24FI15azZTAOtDdRyZAOZe84ru0GTps2g0P1r7pcjVeMZE5rMm6Yduh3nktt1CaHHesk/XUW5W4sp8v4lfTm5ywN9eCBCQz/baOBLE0Ua3rgg4z/DPCUmz5xD2SvWU6IpIBXjYTIKXDahoNtHvUmho/KMZ5HmN6f31FZT2+Wjbmix12dkZtNoTwYO9P8dT+A0mTecMNBNwPmnKmnyrDyKhxnv1U4B0d5f9KmkyHPaPinMwfYrJxKu7v8GPajxMDkFKpsQ0JMJ2KZjmm8e9817CjxNt/O4Odjf+JZaj2/zDXQ06EGNJ1CSSdws7dDNAsvsr7OXr3UWVeG6x87wv5WXOD9jAzZbtf7md669nscP3KbOLa2gaE+Xc27axl2UWbB0xLxvFmnmuJnTzU/7e+wuIJXjSYJToNK0Q/ebi41Du3Xz20bZBGJX3fH3Mav0jqpyd9Xvt3o3W0Ezt492H/tZQY8nUIpJ3izt0J39s8/L7q9N03NWb/LVhOuferZyWYuX0WDnD2evHv+XOPs5sdc4+/RFRX+eECFnn25eqRpPkpwClacdeqBucDNWAoDOikmWCNBl8WS5AXRWTLJEgC6LJ8sNoLNikiUCdFk8WW4AnRWTLBGgy+LJcgPorJhkiQBdFk+WG0BnxSRLBOiyeLLcADorJlkiQJfFk+UG0FkxyRIBuiyeLDeAzopJlgjQZfFkuQF0VkyyRIAuiyfLDaCzYpIlAnRZPFluAJ0VkywRoMviyXID6KyYZIkAXRZPlhtAZ8UkSwTosniy3AA6KyZZIkCXxZPlBtBZMckSAbosniw3gM6KSZYI0GXxZLkBdFZMskSALosnyw2gs2KSJQJ0WTxZbgCdFZMsEaDL4slyA+ismGSJAF0WT5YbQGfFJEsE6LJ4stwAOismWSJAl8WT5QbQWTHJEgG6LJ4sN4DOikmWCNBl8WS5AXRWTLJEgC6LJ8sNoLNikiUCdFk8WW4AnRWTLNFvXskYA3TG3JwAAAAASUVORK5CYII="

因为图片的 Base64 编码比较长，下面只显示生成的图片效果。

Random.dataImage('200x100')

Random.dataImage('300x100', 'Hello Mock.js!')

6.3 Color

6.3.1 Random.color()

• Random.color()

随机生成一个颜色，格式为 ‘#RRGGBB’。

示例如下：

Random.color()
// => "#3538b2"

6.4 Helpers

6.4.1 Random.capitalize(word)

• Random.capitalize(word)

把字符串的第一个字母转换为大写。

示例如下：

Random.capitalize('hello')
// => "Hello"

6.4.2 Random.upper(str)

• Random.upper(str)

把字符串转换为大写。

示例如下：

Random.upper('hello')
// => "HELLO"

6.4.3 Random.lower(str)

• Random.lower(str)

把字符串转换为小写。

示例如下：

Random.lower('HELLO')
// => "hello"

6.4.4 Random.pick(arr)

• Random.pick(arr)

从数组中随机选取一个元素，并返回。

示例如下：

Random.pick(['a', 'e', 'i', 'o', 'u'])
// => "o"

6.4.5 Random.shuffle(arr)

• Random.shuffle(arr)

打乱数组中元素的顺序，并返回。

示例如下：

Random.shuffle(['a', 'e', 'i', 'o', 'u'])
// => ["o", "u", "e", "i", "a"]

6.5 Text

6.5.1 Random.paragraph(len)

• Random.paragraph()
• Random.paragraph(len)
• Random.paragraph(min, max)

随机生成一段文本。

参数及默认值如下：

• len：可选。指示文本中句子的个数。默认值为 3 到 7 之间的随机数。
• min：可选。指示文本中句子的最小个数。默认值为 3。
• max：可选。指示文本中句子的最大个数。默认值为 7。

示例如下：

Random.paragraph()
// => "Yohbjjz psxwibxd jijiccj kvemj eidnus disnrst rcconm bcjrof tpzhdo ncxc yjws jnmdmty. Dkmiwza ibudbufrnh ndmcpz tomdyh oqoonsn jhoy rueieihtt vsrjpudcm sotfqsfyv mjeat shnqmslfo oirnzu cru qmpt ggvgxwv jbu kjde. Kzegfq kigj dtzdd ngtytgm comwwoox fgtee ywdrnbam utu nyvlyiv tubouw lezpkmyq fkoa jlygdgf pgv gyerges wbykcxhwe bcpmt beqtkq. Mfxcqyh vhvpovktvl hrmsgfxnt jmnhyndk qohnlmgc sicmlnsq nwku dxtbmwrta omikpmajv qda qrn cwoyfaykxa xqnbv bwbnyov hbrskzt. Pdfqwzpb hypvtknt bovxx noramu xhzam kfb ympmebhqxw gbtaszonqo zmsdgcku mjkjc widrymjzj nytudruhfr uudsitbst cgmwewxpi bye. Eyseox wyef ikdnws weoyof dqecfwokkv svyjdyulk glusauosnu achmrakky kdcfp kujrqcq xojqbxrp mpfv vmw tahxtnw fhe lcitj."

Random.paragraph(2)
// => "Dlpec hnwvovvnq slfehkf zimy qpxqgy vwrbi mok wozddpol umkek nffjcmk gnqhhvm ztqkvjm kvukg dqubvqn xqbmoda. Vdkceijr fhhyemx hgkruvxuvr kuez wmkfv lusfksuj oewvvf cyw tfpo jswpseupm ypybap kwbofwg uuwn rvoxti ydpeeerf."

Random.paragraph(1, 3)
// => "Qdgfqm puhxle twi lbeqjqfi bcxeeecu pqeqr srsx tjlnew oqtqx zhxhkvq pnjns eblxhzzta hifj csvndh ylechtyu."

6.5.2 Random.sentence(len)

• Random.sentence()
• Random.sentence(len)
• Random.sentence(min, max)

随机生成一个句子，第一个的单词的首字母大写。

参数及默认值如下：

• len：可选。指示句子中单词的个数。默认值为 12 到 18 之间的随机数。
• min：可选。指示句子中单词的最小个数。默认值为 12。
• max：可选。指示句子中单词的最大个数。默认值为 18。

示例如下：

Random.sentence()
// => "Jovasojt qopupwh plciewh dryir zsqsvlkga yeam."
Random.sentence(5)
// => "Fwlymyyw htccsrgdk rgemfpyt cffydvvpc ycgvno."
Random.sentence(3, 5)
// => "Mgl qhrprwkhb etvwfbixm jbqmg."

6.5.3 Random.word(len)

• Random.word()
• Random.word(len)
• Random.word(min, max)

随机生成一个单词。

参数及默认值如下：

• len：可选。指示单词中字符的个数。默认值为 3 到 10 之间的随机数。
• min：可选。指示单词中字符的最小个数。默认值为 3。
• max：可选。指示单词中字符的最大个数。默认值为 10。

示例如下：

Random.word()
// => "fxpocl"
Random.word(5)
// => "xfqjb"
Random.word(3, 5)
// => "kemh"

目前单词中的字符是随机的小写字母，未来会根据词法生成“可读”的单词。

6.5.4 Random.title(len)

• Random.title()
• Random.title(len)
• Random.title(min, max)

随机生成一句标题，其中每个单词的首字母大写。

参数及默认值如下：

• len：可选。指示单词中字符的个数。默认值为 3 到 7 之间的随机数。
• min：可选。指示单词中字符的最小个数。默认值为 3。
• max：可选。指示单词中字符的最大个数。默认值为 7。

示例如下：

Random.title()
// => "Rduqzr Muwlmmlg Siekwvo Ktn Nkl Orn"
Random.title(5)
// => "Ahknzf Btpehy Xmpc Gonehbnsm Mecfec"
Random.title(3, 5)
// => "Hvjexiondr Pyickubll Owlorjvzys Xfnfwbfk"

6.6 Name

6.6.1 Random.first()

• Random.first()

随机生成一个常见的英文名。

示例如下：

Random.first()
// => "Nancy"

6.6.2 Random.last()

• Random.last()

随机生成一个常见的英文姓。

示例如下：

Random.last()
// => "Martinez"

6.6.3 Random.name()

• Random.name()
• Random.name(middle)

随机生成一个常见的英文姓名。

参数及默认值如下：

• middle：可选。布尔值。指示是否生成中间名。

示例如下：

Random.name()
// => "Larry Wilson"
Random.name(true)
// => "Helen Carol Martinez"

6.6.4 Random.chineseName()

• Random.chineseName()
• Random.chineseName(count)

随机生成一个常见的中文姓名。

参数及默认值如下：

• count：可选。数字。指示姓名的字数，默认为 2 个或 3 个字的随机姓名。

示例如下：

Random.chineseName()
// => "林则徐"
Random.chineseName(2)
// => "马云"

Random.chineseName() 可以简写为 Random.cname()。从 Mock 0.2 开始，将只保留 Random.cname()。

6.7 Web

6.7.1 Random.url()

• Random.url()

随机生成一个 URL。

示例如下：

Random.url()
// => "http://vrcq.edu/ekqtyfi"

6.7.2 Random.domain()

• Random.domain()

随机生成一个域名。

示例如下：

Random.domain()
// => "kozfnb.org"

6.7.3 Random.email()

• Random.email()

随机生成一个邮件地址。

示例如下：

Random.email()
// => "x.davis@jackson.edu"

6.7.4 Random.ip()

• Random.ip()

随机生成一个 IP 地址。

示例如下：

Random.ip()
// => "34.206.109.169"

6.7.5 Random.tld()

• Random.tld()

随机生成一个顶级域名。

示例如下：

Random.tld()
// => "net"

6.8 Address

6.8.1 Random.area()

• Random.area()

随机生成一个（中国）大区。

示例如下：

Random.area()
// => "华北"

6.8.2 Random.region()

• Random.region()

随机生成一个（中国）省（或直辖市、自治区、特别行政区）。

示例如下：

Random.region()
// => "辽宁省"

6.9 Miscellaneous

6.9.1 Random.guid()

• Random.guid()

随机生成一个 GUID。

示例如下：

Random.guid()
// => "662C63B4-FD43-66F4-3328-C54E3FF0D56E"

6.9.2 Random.id()

• Random.id()

随机生成一个 18 位身份证。

示例如下：

Random.id()
// => "420000200710091854"

6.9.3 Random.increment(step)

生成一个全局的自增整数。

• Random.increment(step)

参数及默认值如下：

• step：可选。整数自增的步长。默认值为 1。

示例如下：

Random.increment()
// => 1
Random.increment(100)
// => 101
Random.increment(1000)
// => 1101

---

参考文献：

1. 官网
2. mockjs文档