Mock簡明文檔

Mock.mock()

• Mock.mock( requestUrl?, requestType?, template|function(options) )
• Mock.mock( template )
• Mock.mock( requestUrl, template )
• Mock.mock( requestUrl, requestType, template )
• Mock.mock( requestUrl, requestType, function(options) )

requestUrl: 要攔截的URL，字符串或正則表達式

equestType: 要攔截的請求類型，get/post/put/delete/options...

template: 數(shù)據(jù)模板

function(options)：生成響應(yīng)數(shù)據(jù)的函數(shù)，options --> { url, type, body }

語法規(guī)范

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

數(shù)據(jù)模板中每個屬性由3部分組成： 屬性名|生成規(guī)則：屬性值

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.dcout': value
7. 'name|+step': value

屬性值中可以包含@占位符
屬性值還指定了最終值的初始值和類型

1.屬性值是字符串

1. 'name|min-max': string

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

2. 'name|count': string

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

2.屬性值是數(shù)字

1. 'name|+1': number

屬性值自動加 1，初始值為 number

2. 'name|min-max': number

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

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

生成一個浮點數(shù)，整數(shù)部分大于等于 min、小于等于 max，小數(shù)部分保留 dmin 到 dmax 位

3.屬性值是布爾值

1. 'name|1': boolean

隨機生成一個布爾值，值為 true 的概率是 1/2，值為 false 的概率同樣是 1/2

2. 'name|min-max': value

隨機生成一個布爾值，值為 value 的概率是 min / (min + max)，值為 !value 的概率是 max / (min + max)

4.屬性值是對象

1. 'name|count': object

從屬性值 object 中隨機選取 count 個屬性

2. 'name|min-max': object

從屬性值 object 中隨機選取 min 到 max 個屬性

5.屬性值是數(shù)組

1. 'name|1': array

從屬性值 array 中隨機選取 1 個元素，作為最終值

2. 'name|+1': array

從屬性值 array 中順序選取 1 個元素，作為最終值

3. 'name|min-max': array

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

4. 'name|count': array

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

6.屬性值是函數(shù)

1. 'name': function

執(zhí)行函數(shù) function，取其返回值作為最終的屬性值，函數(shù)的上下文為屬性 'name' 所在的對象

7.屬性值是正則表達式

1. 'name': regexp

根據(jù)正則表達式 regexp 反向生成可以匹配它的字符串。用于生成自定義格式的字符串

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

1. 用 @ 來標識其后的字符串是 占位符
2. 占位符 引用的是 Mock.Random 中的方法
3. 通過 Mock.Random.extend() 來擴展自定義占位符
4. 占位符 也可以引用 數(shù)據(jù)模板 中的屬性
5. 占位符 會優(yōu)先引用 數(shù)據(jù)模板 中的屬性
6. 占位符 支持 相對路徑 和 絕對路徑

Mock.setup()

配置Ajax請求的行為，暫時支持的配置項有timeout

  Mock.setup({
    timeout: 500
  })
  Mock.setup({
    timeout: '100-600'
  })

Mock.Random

  const Random = Mock.Random
  Random.email() // => sd.sdf@oksd.com
  Mock.mock('@email') // => sd.sdf@oksd.com
  Mock.mock({ email: 'sd.sdf@oksd.com' }) // => { email: "sd.sdf@oksd.com" }

Mock.Random提供的完整方法（占位符）:

Basic

1. Random.boolean(min?, max?, current? )
2. Random.natural(min?, max? )
3. Random.integer(min?, max? )
4. Random.float( min?, max?, dmin?, dmax? )
5. Random.character( pool? ) // pool => lower/upper/number/symbol
6. Random.string( pool?, min?, max? ) // pool => lower/upper/number/symbol
7. Random.range( start?, stop, step? )

Date

1. Random.date( format? )

2. Random.time( format? )
3. Random.datetime( format? )
4. Random.now( unit?, format? ) // unit => year、month、week、day、hour、minute、second、week

Image

Random.image()

1. Random.image()
2. Random.image( size )
3. Random.image( size, background )
4. Random.image( size, background, text )
5. Random.image( size, background, foreground, text )
6. Random.image( size, background, foreground, format, text )

Random.dataImage()

1. Random.dataImage()
2. Random.dataImage( size )
3. Random.dataImage( size, text )

Color

1. Random.color() // => #3538B2
2. Random.hex() // => #3538B2
3. Random.rgb() // => rgb(242, 198, 121)
4. Random.rgba() // => rgba(242, 198, 121, 0.13)
5. Random.hsl() // => hsl(345, 82, 71)

Text

1. Random.paragraph( min?, max? )
2. Random.cparagraph( min?, max? )
3. Random.sentence( min?, max? )
4. Random.csentence( min?, max? )
5. Random.word( min?, max? )
6. Random.cword( pool?, min?, max? )
7. Random.title( min?, max? )
8. Random.ctitle( min?, max? )

Name

1. Random.first()
2. Random.last()
3. Random.name( middle? )
4. Random.cfirst()
5. Random.clast()
6. Random.cname()

Web

1. Random.url( protocol?, host? )
2. Random.protocol()
3. Random.domain() // 域名
4. Random.tld() // 頂級域名
5. Random.email( domain? )
6. Random.ip()

Address

1. Random.region()
2. Random.province()
3. Random.city( prefix? )
4. Random.county( prefix? )
5. Random.zip()

Helper

1. Random.capitalize( word )
2. Random.upper( str )
3. Random.lower( str )
4. Random.pick( arr )
5. Random.shuffle( arr )

Miscellaneous

1. Random.guid()
2. Random.id()
3. Random.increment( step? )

擴展

Random.extend({
  fruit () {
    const fruit = ['apple', 'peach', 'lemon']
    return this.pick(fruit)
  }
})
Random.fruit() // => 'peach'
Mock.mock('@fruit')  // => 'lemon'
Mock.mock({
  fruit: '@fruit' // => 'peach'
})

Mock.valid()

Mock.valid( template, data )

Mock.toJSONSchema()

Mock.toJSONSchema( template )