@katalon/chrome-recorder NPM

Katalon Chrome Recorder

This repo provide tools to convert JSON user flows from Google Chrome DevTools Recorder to Katalon test scripts programmatically.

✅ Converts multiple recordings to Katalon tests in one go (out-of-the-box glob support)
🗂 User can pass their custom path to export tests.
💃 Users can also use a dry run to see the interim output of the recordings
👨‍💻 Programmatic API which users can use in their own project to create plugins or custom scripts.

Alternatively, you can export JSON user flows as Katalon test scripts straight away from Chrome DevTools with our Katalon Recorder Chrome extension.

See Create Katalon test using Google Chrome DevTools Recorder to learn more.

🏗 Installation

npm install -g @katalon/chrome-recorder

🚀 Usage

To quickly run the interactive CLI, run:

npx @katalon/chrome-recorder

The CLI will prompt you to enter the path of directory or file of the chrome devtool recordings that you will modify and path to write the generated Katalon tests

⚡️ Transform individual recordings

npx @katalon/chrome-recorder <path to the chrome devtools recording>

⚡️ Transform multiple recordings

npx @katalon/chrome-recorder <path to the chrome devtools recording>*.json

👉 By default output will be written to katalon folder. If you don't have these folders, tool will create it for you or install katalon by running npm init katalon in your project.

You can specify different output directory, specify that via cli

npx @katalon/chrome-recorder <path to the chrome devtools recording> --output=<folder-name>

⚙️ CLI Options

Option	Description
-d, --dry	Dry run the output of the transformed recordings
-o, --output	Output location of the files generated by the exporter

💻 Programmatic API

import { katalonStringifyChromeRecording } from '@katalon/chrome-recorder';

const recordingContent = {
  title: 'recording',
  steps: [
    {
      type: 'setViewport',
      width: 1905,
      height: 223,
      deviceScaleFactor: 1,
      isMobile: false,
      hasTouch: false,
      isLandscape: false,
    },
  ],
};

const stringifiedContent = await katalonStringifyChromeRecording(
  JSON.stringify(recordingContent),
);

console.log(stringifiedContent);
// Console Log output
//
// describe('recording', function () {
//   it('tests recording', function (browser) {
//     browser.windowRect({ width: 1905, height: 223 });
//   });
// });

📝 Documentation

You can find about more about Programmatic API here

🐛 Issues

Issues with this schematic can filed here

If you want to contribute (or have contributed in the past), feel free to add yourself to the list of contributors in the package.json before you open a PR!