har-to-k6
har-to-k6 copied to clipboard
Published
20 hours ago •
grafana
grafana
JSON config representation of K6 script
Content
-
Installation
- Local Installation (recommended)
- Global Installation
- Docker
-
Usage
- CLI Usage
- Programmatic Usage
- Browser Usage
- Specifications
- Credits
Installation
Local Installation (recommended)
While possible to install globally, we recommend that you, if possible, add the converter to the
node_modules of your test project using:
$ npm install --save har-to-k6
Note that this will require you to run the converter with npx har-to-k6 your-har-file or,
if you are using an older version of npm, ``./node_modules/.bin/har-to-k6 your-har-file`.
Global Installation
$ npm install --global har-to-k6
Docker
$ docker pull grafana/har-to-k6:latest
Usage
CLI Usage
Npx
$ npx har-to-k6 archive.har -o my-k6-script.js
From node_modules
$ ./node_modules/.bin/har-to-k6 archive.har -o my-k6-script.js
Global
$ har-to-k6 archive.tar -o my-k6-script.js
Programmatic Usage
Converting
const fs = require("fs");
const { liHARToK6Script } = require("har-to-k6");
async function run () {
const archive = readArchive();
const { main } = await liHARToK6Script(archive);
fs.writeFileSync("./load-test.js", main);
}
Validating
Use validate() to run validation alone. Returns without error for a valid
archive. Throws InvalidArchiveError for validation failure.
const { InvalidArchiveError, validate } = require("har-to-k6");
const archive = readArchive();
try {
validate(archive);
} catch (error) {
if (error instanceof InvalidArchiveError) {
// Handle invalid archive
} else {
throw error;
}
}
Browser Usage
har-to-k6 can be ran in the browser. This exposes the standard
API under harToK6.
Importing as ES module
import { liHARToK6Script } from "har-to-k6";
CommonJS style
const { liHARToK6Script } = require("har-to-k6");
Using a <script> tag
Load standalone.js into your HTML page:
<html>
<head>
<title>HAR Converter</title>
<script src="standalone.js"></script>
<script src="index.js"></script>
</head>
</html>
Example
The API is available:
async function run () {
const archive = readArchive();
harToK6.validate(archive);
const { main } = await harToK6.liHARToK6Script(archive);
displayResult(main);
}
Specifications
- LI-HAR - Static configuration format representing a K6 script
- LI-HAR to K6 converter - JavaScript package or function that converts a given LI-HAR to a K6 script
- LI-HAR to K6 CLI tool - a Node.js CLI tool exposing an interface for converting a given LI-HAR to a K6 script
Credits
Thanks to bookmoons for creating this tool 🎉
grafana