xk6-faker

Random fake data generator for k6.

Altought there is several good JavaScript fake data generator, but using these in k6 tests has several disadvantages (download size, memory usage, startup time, etc). The xk6-faker implemented as a golang extension, so tests starts faster and use less memory. The price is a little bit smaller feature set compared with popular JavaScript fake data generators.

For convenience, the xk6-faker API resembles the popular Faker.js. The category names and the generator function names are often different (due to the underlying go faker library), but the way of use is similar.

For convenient use, the default export of the module is a Faker instance, it just needs to be imported and it is ready for use.

import faker from "k6/x/faker"

export default function() {
console.log(faker.person.firstName())
}

// prints a random first name

For a reproducible test run, a random seed value can be passed to the constructor of the Faker class.

import { Faker } from "k6/x/faker"

const faker = new Faker(11)

export default function() {
console.log(faker.person.firstName())
}

Output (formatted as JSON value)

"Josiah"

The reproducibility of the test can also be achieved using the default Faker instance, if the seed value is set in the XK6_FAKER_SEED environment variable.

k6 run --env XK6_FAKER_SEED=11 script.js

then

import faker from "k6/x/faker"

export default function() {
console.log(faker.person.firstName())
}

Output (formatted as JSON value)

"Josiah"

Classes

Faker

Interfaces

Address
Animal
App
Beer
Book
Car
Celebrity
Color
Company
Emoji
Error
File
Finance
Food
Game
Hacker
Hipster
Internet
Language
Minecraft
Movie
Numbers
Payment
Person
Product
Strings
Time
Word
Zen

Variables

default