接上篇Fake data文章 - Python篇。本文主要介紹基于JavaScript的fake data generator。
API https://randomuser.me/
randomuser.me提供一個APIhttps://randomuser.me/api/來返回隨機用戶數據，免費且十分方便好用。下面我們來看如何使用這個API。
多格式
簡單的一個GET請求https://randomuser.me/api/即可獲得包含用戶數據的response，默認格式是JSON，但通過?format=xxx參數我們可以指定不同的數據格式，目前支持的有
- JSON (default)
- PrettyJSON or pretty
- CSV
- YAML
- XML
結合chakram我們來看看這個API如何使用
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API in different format", function () {
it("should return JSON", function () {
return chakram.get(randomuserURL).then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
it("should return YAML", function () {
return chakram.get(randomuserURL + "?format=yaml").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
it("should return XML", function () {
return chakram.get(randomuserURL + "?format=xml").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
});
多用戶
?results=5000參數可以一次性返回多個用戶數據。上限是5000。
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should two prettyJSON", function () {
return chakram.get(randomuserURL + "?format=pretty&results=2").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
});
定制性別相關數據
?gender=male或?gender=female可以返回數據去接近于male還是female
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should return male", function () {
return chakram.get(randomuserURL + "?gender=male").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
});
產生一樣的數據
?seed=danteyu可以讓每次執行產生一致的數據。Seeds可以為任意字符串。比如下面的代碼重復執行會產生一致的結果。
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should seed", function () {
return chakram.get(randomuserURL + "?seed=danteyu").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
});
Locale
locale可以通過?nat=us。通過設置locale，可以返回更加真實的適用于不同國籍的數據。
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should return CH", function () {
return chakram.get(randomuserURL + "?nat=ch").then(function(response){
console.log(response.body.results[0]);
expect(response).to.have.status(200);
});
});
});
刷選特定數據
如果只是想要返回特定的幾個數據可以使用?inc=gender,name,nat來包含只需要返回的數據或是?exc=login來排除不想要的數據。
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should return name and gender", function () {
return chakram.get(randomuserURL + "?inc=name,gender").then(function(response){
console.log(response.body);
expect(response).to.have.status(200);
});
});
});
使用?noinfo可以只返回用戶數據而沒有seed,result和version等數據。
var chakram = require('./node_modules/chakram/lib/chakram.js'),
expect = chakram.expect;
const randomuserURL = "https://randomuser.me/api/";
describe("try random user API", function () {
it("should return only user data", function () {
return chakram.get(randomuserURL + "?noinfo").then(function(response){
console.log(response.body.results);
expect(response).to.have.status(200);
});
});
});
下面為輸出
> randomuser@1.0.0 test /Users/diyu/workspace/chakram
> mocha demo.js
try random user API
[ { gender: 'male',
name: { title: 'mr', first: 'ryan', last: 'mackay' },
location:
{ street: '6297 richmond ave',
city: 'stratford',
state: 'new brunswick',
postcode: 77478 },
email: 'ryan.mackay@example.com',
login:
{ username: 'heavywolf629',
password: 'method',
salt: 'EVZMskM7',
md5: '6756ee051abaccca0214c997204d8d67',
sha1: '4c265c506210e365c9e1acadcdc2321fe899d8c4',
sha256: '90dfbb565010f9524be4531ec8fc712aad3fca69658976c8dc7615a84afa86b9' },
dob: '1979-08-06 17:27:58',
registered: '2002-04-02 00:35:37',
phone: '448-153-9250',
cell: '979-394-3188',
id: { name: '', value: null },
picture:
{ large: 'https://randomuser.me/api/portraits/men/62.jpg',
medium: 'https://randomuser.me/api/portraits/med/men/62.jpg',
thumbnail: 'https://randomuser.me/api/portraits/thumb/men/62.jpg' },
nat: 'CA' } ]
? should return only user data (990ms)
1 passing (999ms)
Faker
類似python的faker提供了各類各樣數據。Faker的使用非常簡單，直接引用調用就行了。下面例子列舉了部分常用數據類型。
const faker = require('faker');
//address
console.log(faker.address.zipCode());
console.log(faker.address.city());
//commerce
console.log(faker.commerce.product());
console.log(faker.commerce.department());
//company
console.log(faker.company.companyName());
console.log(faker.company.bsBuzz());
//date
console.log(faker.date.future());
console.log(faker.date.month());
console.log(faker.date.weekday());
//finance
console.log(faker.finance.account());
console.log(faker.finance.transactionType());
//internet
console.log(faker.internet.email());
console.log(faker.internet.ip());
//lorem
console.log(faker.lorem.words());
console.log(faker.lorem.text());
//name
console.log(faker.name.findName());
console.log(faker.name.jobTitle());
//phone
console.log(faker.phone.phoneNumber());
Faker.fake()可以接受不同的API來組合字符串。
const faker = require('faker');
console.log(faker.fake("{{company.companyName}}, {{internet.email}} {{phone.phoneNumber}}"))
同樣地，faker也支持多個locale。通過下面代碼，可以進行設置。
const faker = require('faker');
faker.locale = "zh_CN";
faker也支持seed()來產生一致的數據，這樣的數據多用于單元測試等場景中。重復執行下面的代碼會產生一致的結果。
const faker = require('faker');
faker.seed(123);
console.log(faker.company.companyName());
faker也有CLI和JSON Schema對應的實現。
