Example k6 extension

This k6 extension showcases how to develop a k6 JavaScript extension using simple functions. It serves as the basis for new JavaScript extensions created with the xk6 new command. Additionally, this repository functions as a GitHub template for creating k6 extension repositories.

import { greeting } from "k6/x/example";

export default function () {
  console.log(greeting()) // Hello, World!
  console.log(greeting("Joe")) // Hello, Joe!
}

1. Create a GitHub repository. This can be done interactively in a browser by clicking here.

   Alternatively, use the GitHub CLI to create the repository.

   gh repo create -p grafana/xk6-example -d "Experimental k6 extension" --public xk6-quickstart

2. Create a codespace. Go to the repository you created in the previous step. Click the green Code button and then select Codespaces from the dropdown menu. Click Create new codespace.

   Alternatively, use the GitHub CLI to create the codespace, replacing USER with your GitHub username:

   gh codespace create --repo USER/xk6-quickstart --web

   Once the codespace is ready, it will open in your browser as a Visual Studio Code-like environment, letting you begin working on your project with the repository code already checked out.

3. Run the test script. The repository's root directory includes a script.js file. When developing k6 extensions, use the xk6 run command instead of k6 run to execute your scripts.

   xk6 run script.js

While using a GitHub codespace in the browser is a good starting point, you can also set up a local development environment for a better developer experience.

To create a local development environment, you need an IDE that supports Development Containers. Visual Studio Code supports Development Containers after installing the Dev Containers extension.

1. First, clone the xk6-quickstart repository to your machine and open it in Visual Studio Code. Make sure to replace USER with your GitHub username:

   git clone https://github.com/USER/xk6-quickstart.git
   code xk6-quickstart

2. Visual Studio Code will detect the development container configuration and show a pop-up to open the project in a dev container. Accept the prompt and the project opens in the dev container, and the container image is rebuilt if necessary.

3. Run the test script. The repository's root directory includes a script.js file. When developing k6 extensions, use the xk6 run command instead of k6 run to execute your scripts.

   xk6 run script.js

Building a custom k6 binary with the xk6-example extension is necessary for its use. You can download pre-built k6 binaries from the Releases page.

Use the xk6 tool to build a custom k6 binary with the xk6-example extension. Refer to the xk6 documentation for more information.

If you wish to contribute to this project, please start by reading the Contributing Guidelines.