Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Generating UUIDs

If you want to make a version 4 UUID, you can use the uuidv4 function from the k6 JS lib repository.

JavaScript
import { uuidv4 } from 'https://jslib.k6.io/k6-utils/1.4.0/index.js';

export default function () {
  const randomUUID = uuidv4();
  console.log(randomUUID); // 35acae14-f7cb-468a-9866-1fc45713149a
}

If you really need other UUID versions, you must rely on an external library.

Generate v1 UUIDs

As k6 doesn’t have built-in support for version 1 UUID, you’ll have to use a third-party library.

This example uses a Node.js library called uuid and Browserify (to make it work in k6). For this to work, we first need to go through a few required steps:

  1. Make sure you have the necessary prerequisites installed: Node.js and Browserify

  2. Install the uuid library:

    bash
    $ npm install uuid@3.4.0

  3. Run it through browserify:

    bash
    $ browserify node_modules/uuid/index.js -s uuid > uuid.js

  4. Move the uuid.js file to the same folder as your script file. Now you can import it into your test script:

    JavaScript
    import uuid from './uuid.js';

This example generates a v1 UUID:

JavaScript
import uuid from './uuid.js';

export default function () {
  // Generate a UUID v1
  const uuid1 = uuid.v1();
  console.log(uuid1);
}