Random fake data generator for k6.
Although there are several good JavaScript fake data generators, 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 start 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 usage pattern is similar.
Check out the API documentation here. The TypeScript declaration file can be downloaded from here.
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 nameFor 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: JosiahTest reproducibility 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.jsthen
import faker from "k6/x/faker";
export default function () {
console.log(faker.person.firstName());
}
// as long as XK6_FAKER_SEED is 11
// output: JosiahThe examples directory contains examples of how to use the xk6-faker extension. A k6 binary containing the xk6-faker extension is required to run the examples.
Important
If the search path also contains the k6 command, don't forget to specify which k6 you want to run (for example ./k6).
You can download pre-built k6 binaries from the Releases page.
Build
The xk6 build tool can be used to build a k6 that will include xk6-faker extension:
$ xk6 build --with github.com/szkiba/xk6-faker@latestFor more build options and how to use xk6, check out the xk6 documentation.
If you find the xk6-faker extension useful, please star the repo. The number of stars will determine the time allocated for maintenance.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent