前端開發(fā)過程中免不了出現(xiàn)等接口的情況，而靜態(tài) JSON 不足以體現(xiàn)前端高大上的逼格，是時(shí)候拿出 mock.js 了，眾多在線 Mock API 都是使用的 mock.js 語法哦

Mock.js簡(jiǎn)介

Mock.js 是一款模擬數(shù)據(jù)生成器，旨在幫助前端攻城師獨(dú)立于后端進(jìn)行開發(fā)，幫助編寫單元測(cè)試。

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

功能：

1. 基于 數(shù)據(jù)模板 生成 模擬數(shù)據(jù)；
2. 類型豐富的 隨機(jī)數(shù)據(jù)
3. 模擬 Ajax 請(qǐng)求

個(gè)人應(yīng)用：

使用 Koa 和 mockjs 搭建的本地服務(wù)

個(gè)人倉(cāng)庫(kù)：mock-server，開箱即用，喜歡可以 star ^ _ ^

語法規(guī)范

Mock.js 的語法規(guī)范包括兩部分：

1. 數(shù)據(jù)模板定義（Data Temaplte Definition，DTD）
2. 數(shù)據(jù)占位符定義（Data Placeholder Definition，DPD）

數(shù)據(jù)模板定義 DTD

數(shù)據(jù)模板中的每個(gè)屬性由 3 部分構(gòu)成：屬性名、生成規(guī)則、屬性值：

屬性名|生成規(guī)則：屬性值
'name|rule': value

生成規(guī)則

• 屬性名 和 生成規(guī)則 之間用 | 分隔。

• 生成規(guī)則 是可選的。

• 生成規(guī)則 有 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
  

• 生成規(guī)則的含義需要依賴 屬性值 才能確定。

• 屬性值中可以含有 @占位符。

• 屬性值還指定了最終值的初始值和類型。

String : 屬性值為字符串

• 'name|min-max': string

重復(fù)字符串 string 生成一個(gè)字符串，重復(fù)次數(shù)大于等于 min，小于等于 max

// 生成 1 ~ 10 個(gè) "★"
Mock.mock({
  "string|1-10": "★"
})

// ==> 
{ "string": "★★★★" }

• 'name|count': string

重復(fù)字符串 string 生成一個(gè)字符串，重復(fù)次數(shù)等于count

// 重復(fù) "String" 3 次
Mock.mock({
  "string|3": "String",
})

// ==> 
{ "string": "StringStringString" }

Number : 屬性值為數(shù)字

• 'name|min-max': number

生成一個(gè)大于等于 min、小于等于 max 的整數(shù)，屬性值 number只用來確定Number類型

// 生成一個(gè)整數(shù)，區(qū)間：[1,10]
Mock.mock({
  "number|1-10": 100
})

// ==> 
{ "number": 6 }

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

生成一個(gè)浮點(diǎn)數(shù)，整數(shù)部分大于等于min、小于等于 max，小數(shù)部分保留 dmin 到 dmax 位，屬性值 value 只用來確定Number類型

// number1: 生成一個(gè)小數(shù)，整數(shù)區(qū)間：[1,10], 小數(shù)部分保留 2 到 4 位
// number2: 生成一個(gè)小數(shù)，整數(shù)部分為10, 小數(shù)部分保留 2 到 4 位
// number3: 生成一個(gè)小數(shù)，整數(shù)部分為10, 小數(shù)部分保留 2 位
Mock.mock({
  "number1|1-10.2-4": 100,
  "number2|10.2-4": 100,
  "number3|10.2": 100,
})

// => 
{ 
    "number1": 6.123, 
    "number2": 10.2884,
    "number3": 10.68,
}

• 'name|+step': number

屬性值以 step 遞增，初始值為 number， step不能為負(fù)值

tip: 官網(wǎng)示例關(guān)于Number的這一條示例沒看懂，摸不清Result的刷新規(guī)則，但對(duì)于數(shù)組中應(yīng)從此規(guī)則是很好理解的，示例如下：

// 生成一個(gè)數(shù)組list, 每一項(xiàng)的id 自增 5 ，初始值為100
Mock.mock({
  "list|3": [
    {"id|+5": 100}
  ],
})

// => 
{"list": [
    {id: 100},
    {id: 105},
    {id: 110},
]}

Boolean：屬性值為布爾值

• 'name|1': boolean

隨機(jī)生成一個(gè)布爾值，值為 true 的概率是 1/2，值為 false 的概率是 1/2

// 生成一個(gè)布爾值, 1/2為true, 1/2為false
Mock.mock({
    "boolean|1": true,
})

// => 
{ "boolean": false }

• 'name|min-max': boolean

隨機(jī)生成一個(gè)布爾值，值為 boolean 的概率是 min / (min + max)，值為 !boolean 的概率是 max / (min + max)

// 生成一個(gè)布爾值, 1/3為false, 2/3為true
Mock.mock({
    "boolean|1-2": false,
})

// => 
{ "boolean": false }

Object：屬性值為對(duì)象 Object

• 'name|min-max': object

從屬性值 object 中隨機(jī)選取 min 到 max 個(gè)屬性。

// 生成一個(gè)對(duì)象, 包含 1 ~ 2 個(gè)屬性
Mock.mock({
  "object|1-2": {
    "name": "code",
    "gender": 1,
    "age": 18,
    "tel": "18911112222"
  }
})

// => 
{object: {
    "name": "code",
}}

• 'name|count': object

從屬性值 object 中隨機(jī)選取 count 個(gè)屬性。

// 生成一個(gè)對(duì)象, 包含 2 個(gè)屬性
Mock.mock({
  "object|2": {
    "name": "code",
    "gender": 1,
    "age": 18,
    "tel": "18911112222"
  }
})

// => 
{object: {
    "name": "code",
    "age": 18,
}}

Array : 屬性值為數(shù)組

• 'name|1': array

從屬性值 array 中隨機(jī)選取 1 個(gè)元素，作為最終值

Mock.mock({
  "array|1": [1,2,3,4]
})

// => 
{ array: 1 }

• 'name|count': array

通過重復(fù)屬性值 array 生成一個(gè)新數(shù)組，重復(fù)次數(shù)為 count

Mock.mock({
  "array1|2": [1,2,3],
  "array2|2": [{a:1},2],
})

// => 
{
    array1: [ 1, 2, 3, 1, 2, 3 ],
    array2: [ {a:1}, 2, {a:1}, 2 ]
}

• `'name|min-max': array

通過重復(fù)屬性值 array 生成一個(gè)新數(shù)組，重復(fù)次數(shù)大于等于 min，小于等于 max

Mock.mock({
  "array|1-3": [{id:1, name: 2}],
})

// => 
{array1: [ 
    {id:1, name: 2}, 
    {id:1, name: 2} 
]}

• 'name|+step': array

從下標(biāo) 0 的位置循環(huán)取出array中的元素， 下標(biāo)以 step 遞增并對(duì) array.length 取余

Mock.mock({
  "array|4": [{
      "number|+1": [2,4]
  }]
})

// => 
{array: [
    { number: 2},
    { number: 4},
    { number: 2},
    { number: 4}
]}

Function：屬性值為函數(shù)

• 'name': function(){}

取函數(shù)返回值作為最終的屬性值，上下文為 'name' 所在的對(duì)象。

Mock.mock({
  'firstName': 'Guoda',
  'name': function() {
    var nameObj =  Mock.mock({
      'firstName': 'Jason',
      'lastName': 'Statham',
      'name': function() {
        // 這里的 this.firstName 會(huì)取到 'Jason' 而不會(huì)取到 'Guoda'
        return this.firstName + " " +this.lastName;
      }
    })
    return nameObj.name
  }
})

// => 
{
    "firstName": "Guoda",
    "name": "Jason Statham"
}

RegExp： 屬性值為正則表達(dá)式

• 'name': regexp

Mock.mock({
  'regexp1': /[a-z][A-Z][0-9]/,
  'regexp2': /\d{5,10}/
  'regexp3|1-5': /\d{5,10}\-/,
  'regexp4|3': /\d{2,4}\*/
})

// => 
{
    "regexp1": "cD3",
    "regexp2": "54833",
    "regexp3": "597425-8412964-5862207-7615212-051289-582018-",
    "regexp4": "374*1397*88*027*",
}

Path： 屬性值通過路徑獲取

• Relative Path 相對(duì)路徑

相對(duì)于當(dāng)前屬性名的路徑

var relativePathData = Mock.mock({
  "foo": "Hello",
  "nested": {
    "a": {
      "b": {
        "c": "Mock.js"
      }
    }
  },
  "relativePath": {
    "a": {
      "b": {
        "c": "@../../../foo @../../../nested/a/b/c"
      }
    }
  }
})
console.log(relativePathData.relativePath)
// => 
"Hello Mock.js"

• Absolute Path 絕對(duì)路徑

最外層為根路徑

var absolutePathData = Mock.mock({
  "foo": "Hello",
  "nested": {
    "a": {
      "b": {
        "c": "Mock.js"
      }
    }
  },
  "absolutePath": "@/foo @/nested/a/b/c"
})
console.log(absolutePathData.absolutePath)
// => 
"Hello Mock.js"

數(shù)據(jù)占位符定義 DPD

占位符 只是在屬性值字符串中占個(gè)位置，并不出現(xiàn)在最終的屬性值中

1. 用 @ 來標(biāo)識(shí)其后的字符串是 占位符
2. 占位符 引用的是 Mock.Random 中的方法，建議引用時(shí) 方法名 全大寫，以便在閱讀時(shí)從視覺上提高占位符的識(shí)別度，快速識(shí)別占位符 和 普通字符
3. 通過 Mock.Random.extend() 來擴(kuò)展自定義占位符
4. 占位符 也可以引用 數(shù)據(jù)模板 中的屬性
5. 占位符 會(huì)優(yōu)先引用 數(shù)據(jù)模板 中的屬性
6. 占位符 支持 相對(duì)路徑 和 絕對(duì)路徑。

// @FIRST 和 @first 均可調(diào)用 Mock.Random.first()， 使用大寫易于區(qū)分占位符和字符串
Mock.mock({
     "name": {
         first: '@FIRST',   // @FIRST 引用 Mock.Random.first()
         last: '@LAST',     // @LAST 引用 Mock.Random.last()
         full: '@first @last' // @first 優(yōu)先引用數(shù)據(jù)模版的屬性（this.first）
     }
 })
 // =>
 {"name": {
     "first": "Charles",
     "last": "Lopez",
     "full": "Charles Lopez"
 }}

綜合示例

Mock.mock({
  "list|10": [
    {
      "id": "@GUID",
      "first": "@CFIRST",
      "last": "@CLAST",
      "name": "@first@last",
      "age|10-60": 1,
      "gender": "@pick([1,2])",
      "say": function(){
          return "my name is " + this.name;
      }
    }
  ]
})

Mock.Random

Mock.Random 是一個(gè)工具類，用于生成各種隨機(jī)數(shù)據(jù)，調(diào)用方式有2種：

// 1. 直接調(diào)用 Matn.random 方法
var Random = Mock.Random;
Random.boolean()
Random.boolean(1, 9, true)

// 2. 數(shù)據(jù)占位符調(diào)用
Mock.mock('@boolean')
Mock.mock('@boolean()')
Mock.mock('@boolean(1, 9, true)')

自定義占位符

// 自定義占位符
Mock.Random.extend({
    constellations: [
        '白羊座', '金牛座', '雙子座', '巨蟹座', '獅子座', '處女座', 
        '天秤座', '天蝎座', '射手座', '摩羯座', '水瓶座', '雙魚座'
    ],
    constellation: function(date){
        return this.pick(this.constellations)
    }
})
Random.constellation()
// => "水瓶座"
Mock.mock('@CONSTELLATION')
// => "天蝎座"
Mock.mock({ constellation: '@CONSTELLATION'})
// => { constellation: "射手座" }

Basics

boolean：布爾值

• Random.boolean(min?, max?, current?)

參數(shù)說明參見 數(shù)據(jù)模版定義-Boolean

natural：自然數(shù)（大于等于 0 的整數(shù)）

• Random.natural( min?, max? )

參數(shù) min：可選。指示隨機(jī)自然數(shù)的最小值。默認(rèn)值為 0。

參數(shù) max：可選。指示隨機(jī)自然數(shù)的最小值。默認(rèn)值為 9007199254740992。

integer：整數(shù)（包含負(fù)數(shù)）

• Random.integer( min?, max? )

參數(shù) min：可選。指示隨機(jī)整數(shù)的最小值。默認(rèn)值為 -9007199254740992。

參數(shù) max：可選。指示隨機(jī)整數(shù)的最大值。默認(rèn)值為 9007199254740992。

float：浮點(diǎn)數(shù)

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

參數(shù) min：可選。整數(shù)部分的最小值。默認(rèn)值為 -9007199254740992。

參數(shù) max：可選。整數(shù)部分的最大值。默認(rèn)值為 9007199254740992。

參數(shù) dmin：可選。小數(shù)部分 位數(shù) 的最小值。默認(rèn)值為 0。

參數(shù) dmin：可選。小數(shù)部分 位數(shù) 的最大值。默認(rèn)值為 17。

character：?jiǎn)蝹€(gè)字符

• Random.character( pool? )

參數(shù) pool：可選。字符串。表示字符池，將從中選擇一個(gè)字符返回。

如果傳入 'lower' 或 'upper'、'number'、'symbol'，表示從內(nèi)置的字符池從選取。

如果未傳入該參數(shù)，則從 'lower' + 'upper' + 'number' + 'symbol' 中隨機(jī)選取一個(gè)字符返回。

內(nèi)置字符池：
lower: "abcdefghijklmnopqrstuvwxyz",
upper: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
number: "0123456789",
symbol: "!@#$%^&*()[]"

string：字符串

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

參數(shù) pool：可選。字符串。釋義同上字符。

參數(shù) min：可選。隨機(jī)字符串的最小長(zhǎng)度。默認(rèn)值為 3。

參數(shù) max：可選。隨機(jī)字符串的最大長(zhǎng)度。默認(rèn)值為 7。

range：整型數(shù)組

• Random.range(stop)

一個(gè)參數(shù)：表示數(shù)組中整數(shù)的結(jié)束值（不包含在返回值中）

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

參數(shù) start：可選。數(shù)組中整數(shù)的起始值，默認(rèn)值為 0。

參數(shù) stop：必選。數(shù)組中整數(shù)的結(jié)束值（不包含在返回值中）。

參數(shù) step：可選。數(shù)組中整數(shù)之間的步長(zhǎng)，默認(rèn)值為 1。

// 一個(gè)參數(shù)表示結(jié)束值
Random.range(10)
// => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
// 多參數(shù)
Random.range(3, 7)
// => [3, 4, 5, 6]
Random.range(1, 10, 2)
// => [1, 3, 5, 7, 9]
Random.range(1, 10, 3)
// => [1, 4, 7]

Date

參數(shù) format：可選。格式化生成的日期字符串。默認(rèn)值為 yyyy-MM-dd。可選值參照 date-format

date：日期字符串

• Random.date( format? )

time：時(shí)間字符串

• Random.time(format?)

datetime：隨機(jī)的日期和時(shí)間字符串

• Random.datetime( format? )

now：當(dāng)前的日期和時(shí)間字符串

• Random.now( unit?, format? )

參數(shù) unit：可選。表示時(shí)間單元，用于對(duì)當(dāng)前日期和時(shí)間進(jìn)行格式化。

? 可選值有：year、month、week、day、hour、minute、second、week，默認(rèn)不會(huì)格式化。

參數(shù) format：可選。指示生成的日期和時(shí)間字符串的格式。默認(rèn)值為 yyyy-MM-dd HH:mm:ss。

Random.now()
// => "2018-11-09 10:28:53"

// Ranndom.now( unit )
    Random.now('year')
    // => "2018-01-01 00:00:00"
    Random.now('month')
    // => "2018-11-01 00:00:00"
    Random.now('week')
    // => "2018-11-04 00:00:00"
    Random.now('day')
    // => "2018-11-09 00:00:00"
    Random.now('hour')
    // => "2018-11-09 20:00:00"
    Random.now('minute')
    // => "2018-11-09 20:08:00"
    Random.now('second')
    // => "2018-11-09 20:08:38"

// Ranndom.now( unit, format )
    Random.now('day', 'yyyy-MM-dd HH:mm:ss SS')
    // => "2018-11-09 00:00:00 000"

Image

image：圖片URL

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

參數(shù) size：可選。指示圖片的寬高，格式為 '寬x高'。默認(rèn)從下面的數(shù)組中隨機(jī)讀取一個(gè)

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

參數(shù) background：可選。圖片的背景色（16進(jìn)制顏色）。默認(rèn)值為 '#000000'。使用英文單詞(red等)表示顏色無效

參數(shù) foreground：可選。圖片的前景色（文件）。默認(rèn)值為 '#FFFFFF'。使用英文單詞(red等)表示顏色無效

參數(shù) format：可選。指示圖片的格式。默認(rèn)值為 'png'，可選值包括：'png'、'gif'、'jpg'。

參數(shù) text：可選。指示圖片上的文字(中文無效)。默認(rèn)為參數(shù) size（尺寸大小 eg：200x100）。

Random.image('200x100', '#FF0000', '#FFF', 'png', 'text')
// =>
"https://dummyimage.com/200x100/FF0000/FFF.png&text=text"

dataImage：base64圖片

• Random.dataImage( size?, text? )

圖片的背景色是隨機(jī)的，取值范圍參考自 http://brandcolors.net/。

Color

color：'#RRGGBB'

• Random.color()

返回16進(jìn)制顏色（'#RRGGBB'）

hex : '#RRGGBB'

• Random.hex()

返回16進(jìn)制顏色（'#RRGGBB'）

rgb：'rgb(r, g, b)'

• Random.rgb()

rgba：'rgb(r, g, b, a)'

• Random.rgba()

hsl：'hsl(h, s, l)'

• Random.hsl()

Random.color()
// => "#f279c3"
Random.hex()
// => "#7988f2"
Random.rgb()
// => "rgb(242, 184, 121)"
Random.rgba()
// => "rgba(242, 121, 164, 0.58)"
Random.hsl()
// => "hsl(286, 82, 71)"

Text

paragraph：英文段落（多條句子）

• Random.paragraph( len )

參數(shù) len：可選。指示文本中句子的個(gè)數(shù)。默認(rèn)值為 3 到 7 之間的隨機(jī)數(shù)。

• Random.paragraph( min?, max? )

參數(shù) min：可選。指示文本中句子的最小個(gè)數(shù)。默認(rèn)值為 3。

參數(shù) max：可選。指示文本中句子的最大個(gè)數(shù)。默認(rèn)值為 7。

sentence：一個(gè)英文句子

隨機(jī)生成一個(gè)句子，第一個(gè)的單詞的首字母大寫。

• Random.sentence( len )

參數(shù) len：可選。指示句子中單詞的個(gè)數(shù)。默認(rèn)值為 12 到 18 之間的隨機(jī)數(shù)。

• Random.sentence( min?, max? )

參數(shù) min：可選。指示句子中單詞的最小個(gè)數(shù)。默認(rèn)值為 12。

參數(shù) max：可選。指示句子中單詞的最大個(gè)數(shù)。默認(rèn)值為 18。

word：英文單詞

• Random.word( len )

參數(shù) len：可選。指示單詞中字符的個(gè)數(shù)。默認(rèn)值為 3 到 10 之間的隨機(jī)數(shù)。

• Random.word( min?, max? )

參數(shù) min：可選。指示單詞中字符的最小個(gè)數(shù)。默認(rèn)值為 3。

參數(shù) max：可選。指示單詞中字符的最大個(gè)數(shù)。默認(rèn)值為 10。

Random.word()
// => "fzljqtu"

title：標(biāo)題

隨機(jī)生成一句標(biāo)題，其中每個(gè)單詞的首字母大寫。

• Random.title( len )

參數(shù) len：可選。指示標(biāo)題中單詞的個(gè)數(shù)。默認(rèn)值為 3 到 7 之間的隨機(jī)數(shù)。

• Random.title( min?, max? )

參數(shù) min：可選。指示標(biāo)題中單詞的最小個(gè)數(shù)。默認(rèn)值為 3。

參數(shù) max：可選。指示標(biāo)題中單詞的最大個(gè)數(shù)。默認(rèn)值為 7。

Random.title()
// => "Odd Krdote Tidnsovvr Gcljiwzk Gtbckxopbg Vhfr"

cparagraph：中文段落

參數(shù)同 paragraph

• Random.cparagraph( len )

• Random.cparagraph( min?, max? )

Random.cparagraph()
// => "科叫強(qiáng)上全六黨爭(zhēng)很溫素通。增精老新節(jié)勞人要格原山設(shè)總。可京條眼作少空么屬氣眾原并是結(jié)型。社馬高率主約樣明只事過且往除。"

csentence：中文句子

參數(shù)同 sentence

• Random.cparagraph( len )
• Random.cparagraph( min?, max? )

Random.csentence()
// => "氣想指選價(jià)領(lǐng)金高每提實(shí)式轉(zhuǎn)。"

cword：漢字

• Random.cword(pool？）
• Random.cword(pool？, length？）
• Random.cword( pool?, min?, max? )
• Random.cword(length？）
• Random.cword(min, max）

參數(shù) pool：可選。字符串。表示字符池，將從中選擇漢字返回(可重復(fù)選擇)。

參數(shù) length：可選。指示隨機(jī)漢字的長(zhǎng)度，默認(rèn)值為 1。

參數(shù) min：可選。指示隨機(jī)漢字的最小長(zhǎng)度。

參數(shù) max：可選。指示隨機(jī)漢字的最大長(zhǎng)度。

// Random.cword()
Random.cword()
// => "況"

// Random.cword( pool )
Random.cword('零一二三四五六七八九十')
// => "十"

// Random.cword( length )
Random.cword(3)
// => "萬為此"

// Random.cword( pool, length )
Random.cword('零一二三四五六七八九十', 3)
// => "五三六"

// Random.cword( min, max )
Random.cword(3, 5)
// => "眼克好金少"

// Random.cword( pool, min, max )
Random.cword('零一二三四五六七八九十', 5, 7)
// => "二五五八三六"

ctitle：中文標(biāo)題

• Random.ctitle(length？）
• Random.ctitle(min, max）

參數(shù) length：可選。指示隨機(jī)標(biāo)題的長(zhǎng)度。

參數(shù) min：可選。指示隨機(jī)標(biāo)題的最小長(zhǎng)度，默認(rèn)值為3。

參數(shù) max：可選。指示隨機(jī)標(biāo)題的最大長(zhǎng)度，默認(rèn)值為7。

Random.ctitle(3, 5)
// => "路屬改往"

Name

first：英文名

• Random.first()

隨機(jī)生成一個(gè)常見的英文名。

last：英文姓

• Random.last()

隨機(jī)生成一個(gè)常見的英文姓。

name：英文姓名

• Random.name( middle? )

隨機(jī)生成一個(gè)常見的英文姓名。

參數(shù) middle：可選。布爾值。指示是否生成中間名。

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

cfirst：中文姓

• Random.cfirst()

隨機(jī)生成一個(gè)常見的中文姓氏。

clast：中文名

• Random.clast()

隨機(jī)生成一個(gè)常見的中文名。

cname：中文姓名

• Random.cname()

Random.cname()
// => "薛靜"

Web

url：url地址

• Random.url()

Random.url()
// => "gopher://qmug.sh/uprwjbph"

domain：域名

• Random.domain()

Random.domain()
// => "ynadsh.tj"

protocal：協(xié)議

• Random.protocol()

Random.protocol()
// => "http"

tld：頂級(jí)域名

• Random.tld()

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

ip

• Random.ip()

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

email：郵箱

• Random.email()

Random.email()
// => "t.tfiktg@krrsjpfs.mil"

Address

region：大區(qū)

• Random.region()

隨機(jī)生成一個(gè)（中國(guó)）大區(qū)。

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

province：省（或直轄市、自治區(qū)、特別行政區(qū)）

• Random.province()

Random.city()
// => "安徽省"

city：城市

• Random.city( prefix? )

參數(shù) prefix：可選。布爾值。指示是否生成所屬的省。默認(rèn)值為 false。

Random.city()
// => "海東市"
Random.city(true)
// => "吉林省 吉林市"

county：縣（區(qū)）

• Random.county( prefix? )

參數(shù) prefix：可選。布爾值。指示是否生成所屬的省、市。默認(rèn)值為 false。

Random.county()
// => "永勝縣"
Random.county(true)
// => "河南省 安陽(yáng)市 龍安區(qū)"

zip：郵政編碼

• Random.zip()

隨機(jī)生成一個(gè)郵政編碼（六位數(shù)字）

Random.zip()
// => "139862"

Helper：工具類

capitalize：首字母大寫

• Random.capitalize( word )

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

upper：大寫轉(zhuǎn)換

• Random.upper( str )

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

lower：小寫轉(zhuǎn)換

• Random.lower( str )

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

pick：元素選取

• Random.pick( arr )

從數(shù)組中隨機(jī)選取一個(gè)元素，并返回

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

shuffle：打亂

• Random.shuffle( arr )

打亂數(shù)組中元素的順序，并返回。

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

Miscellaneous：雜項(xiàng)

guid：隨機(jī)標(biāo)識(shí)符

• Random.guid()

隨機(jī)生成一個(gè) GUID。Random.guid() 的實(shí)現(xiàn)參考了 UUID 規(guī)范。

Random.guid()
// => "8Dc8DA10-3FDe-FFc8-3AD6-703bdeFff0D8"

id：18 位身份證。

• Random.id()

// 隨機(jī)生成一個(gè) 18 位身份證。
Random.id()
// => "620000201010107263"

increment：自增整數(shù)

• Random.increment( step? )

參數(shù) step：可選。整數(shù)自增的步長(zhǎng)。默認(rèn)值為 1。起始值為0。

生成一個(gè) 全局 的自增整數(shù)。

全局變量！！！

// 仔細(xì)觀察每次調(diào)用 Random.increment 后的返回值
Random.increment()
// => 1 （0+1）
Random.increment()
// => 2 （1+1）
Random.increment(100)
// => 102 （2+100）
Random.increment()
// => 103 (102+1)

Mock.mock()

Mock.js 通過覆蓋和模擬原生 XMLHttpRequest 的行為來攔截 Ajax 請(qǐng)求

當(dāng)前版本只能攔截Ajax請(qǐng)求，故對(duì)此方法不做過多記錄，有興趣的同學(xué)可以查看 官方文檔

Mock.mock( rurl?, rtype?, template|function( options ) )

• Mock.mock( template )
• Mock.mock( rurl, template )
• Mock.mock( rurl, function(options) )
• Mock.mock( rurl, rtype, template )
• Mock.mock( rurl, rtype, function(options) )

參數(shù) rurl：可選。表示需要攔截的 URL，可以是 URL 字符串或 URL 正則。

? 例如 /\/domain\/list\.json/、'/domian/list.json'。

參數(shù) rtype：可選。表示需要攔截的 Ajax 請(qǐng)求類型。

? 例如 GET、POST、PUT、DELETE 等。

參數(shù) template：可選。表示數(shù)據(jù)模板，可以是對(duì)象或字符串。

? 例如 { 'data|1-10':[{}] }、'@EMAIL'。

參數(shù) function(options)：可選。表示用于生成響應(yīng)數(shù)據(jù)的函數(shù)。

參數(shù) options：指向本次請(qǐng)求的 Ajax 選項(xiàng)集。

? 含有 url、type 和 body 三個(gè)屬性，參見 XMLHttpRequest 規(guī)范。

// Mock.mock( rurl, rtype, template )
Mock.mock(/\.json/, 'post', {
    'list|1-10': [{
        'id|+1': 1,
        'email': '@EMAIL'
    }]
})
$.ajax({
    url: 'list.json',
    type: 'post',
    dataType: 'json'
}).done(function (data, status, jqXHR) {
    console.log(data)
})

Mock.setup(settings )

參數(shù)settings：必選。指示配置項(xiàng)對(duì)象。配置攔截 Ajax 請(qǐng)求時(shí)的行為。

Mock.setup( settings ) 僅用于配置 Ajax 請(qǐng)求，同上，有興趣的同學(xué)可以查看 官方文檔

settings：配置項(xiàng)

timeout

可選。指定被攔截的 Ajax 請(qǐng)求的響應(yīng)時(shí)間，單位是毫秒。

值可以是正整數(shù)，例如 400，表示 400 毫秒 后才會(huì)返回響應(yīng)內(nèi)容

也可以 '200-600'，表示響應(yīng)時(shí)間介于 200 和 600 毫秒之間。默認(rèn)值是'10-100'。

Mock.setup({
    timeout: 400
})
Mock.setup({
    timeout: '200-600'
})