Generating UUIDs

This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest 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);
}