JTL File Parser

A quick and simple parser for JMeter outputted JTL files. This tool comes with a config file which can be customized to build your output.

Setup

Clone the repository, and run yarn install to initialize

Usage

cli-mode:

$ yarn start -f <input file path> [-o <output file path> -v <for verbose>]

The tool will then use the config supplied under src/config.js to transform the input data into the output format, and write it to the output path (which defaults to the project directory)

module-mode:

First add the lib as a dependency

yarn add jtl-parser

The in code:

import transformJTL from 'jtl-parser';
...

transformJTL({
    f: <input file path>,
    [
        o: <output file path>,
        v: <true for verbose>,
        skipWrite: <true to skip write to file at the end>
    ] 
}).then(processedOutput => ...).catch(err => ...);

Config

The field outputConfig under src/config.js is the hook for data processing.

• Each key in that object is checked for containing a method named transformRow, or transformOutput, and the corresponding function is invoked
• If a key start with '_' it is ignored
• transformRow can be used to store/parse row level values, and is called with three arguments:
  • accumulator: This is a reference to the final object written to the output
  • current row: An object keyed by the corresponding JTL_HEADERS
  • verbose mode: Boolean, are we running in verbose mode?
• transformOutput can be used to add/update data based on the completed processing, and is called with two argument:
  • accumulator: This is a reference to the final object written to the output
  • verbose mode: Boolean, are we running in verbose mode?
• In case of module-mode, you can overwrite the entire contents of outputConfig using the method setOutputConfig before calling the transform