Registry / devops / jmx-k6-migration-kit

jmx-k6-migration-kit

library0.1.0jsnpmunverified

Audit JMeter JMX files and generate safe k6 migration scaffolds with explicit diagnostics. v0.1.0 (initial release). ESM-only, ships TypeScript types, tested on Node 20/22. Unlike full converters, it audits unsupported parts, outputs warnings/TODO comments, and produces structured reports. CLI and API available.

devops

npm install jmx-k6-migration-kit

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · JMX-K6-MIGRATION-K

jmx-k6-migration-kit

devopsjavascriptv0.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

migrateJmxToK6

✓ import { migrateJmxToK6 } from 'jmx-k6-migration-kit'

✗ const migrateJmxToK6 = require('jmx-k6-migration-kit')

ESM-only package; CommonJS require will fail.

analyzeJmx

✓ import { analyzeJmx } from 'jmx-k6-migration-kit'

✗ import { analyzeJmx } from 'jmx-k6-migration-kit/dist/index.js'

Deep imports into dist/ are not supported.

generateK6Script

✓ import { generateK6Script } from 'jmx-k6-migration-kit'

Named export, not default.

formatMigrationReport

✓ import { formatMigrationReport } from 'jmx-k6-migration-kit'

✗ import { formatMigrationReport } from 'jmx-k6-migration-kit/format'

All exports from the package root.

Read a JMX file, migrate it to a k6 script, and write the output. Shows usage of migrateJmxToK6 with options and file I/O.

import { migrateJmxToK6 } from 'jmx-k6-migration-kit'; import { readFileSync, writeFileSync } from 'node:fs'; const jmxXml = readFileSync('./load-test.jmx', 'utf-8'); const result = migrateJmxToK6(jmxXml, { sourceName: 'load-test.jmx', baseUrl: 'https://api.example.com' }); console.log(result.analysis.summary); if (result.k6.ok) { writeFileSync('./load-test.k6.js', result.k6.script, 'utf-8'); console.log('k6 script written to load-test.k6.js'); }

Debug

Known issues

breakingESM-only package: require() will throw ERR_REQUIRE_ESM.

fix

Use import syntax or dynamic import().

affects: >=0.1.0

gotchaOptions object properties like baseUrl and sourceName are required for script generation; omitting baseUrl may generate relative URLs that fail in k6.

fix

Always provide baseUrl, especially if JMX uses relative paths.

affects: >=0.1.0

gotchaCLI command is npx jmx-k6-migrate, not jmx-k6-migration-kit.

fix

Use npx jmx-k6-migrate for CLI.

affects: >=0.1.0

deprecatedNode.js versions below 20 are not supported.

fix

Upgrade to Node.js 20 or later.

affects: >=0.1.0

Errors

Common errors & fixes

ERR_REQUIRE_ESM

Using require() on an ESM-only package.

fix

Replace require() with import or use dynamic import() in CJS context.

Cannot find module 'jmx-k6-migration-kit'

Package not installed or incorrect import path.

fix

Run npm install jmx-k6-migration-kit and use import from 'jmx-k6-migration-kit'.

TypeError: analyzeJmx is not a function

Deep import to internal path or default import when named export expected.

fix

Use import { analyzeJmx } from 'jmx-k6-migration-kit'.

Upgrade

Version history

0.1.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/Recoveredd/jmx-k6-migration-kit ↗

packagejmx-k6-migration-kit ↗

homepagehttps://github.com/Recoveredd/jmx-k6-migration-kit#readme ↗