External Libraries

Bruno allows you to load any npm module or package for use in your scripting workflows.

Always turn on Developer Mode when using external libraries in Bruno.

Prerequisites

Before you begin, ensure that you have the following:

Node.js installed on your system.
Bruno installed.

Project structure

The folder structure depends on your collection format.

Starting with Bruno v3.1.0, YAML (OpenCollection format) is the default file format when creating new collections. Learn more about create collection here.

YAML Collections
Bru Collections

bruno-collection

external-lib

echo-api.yml

auth.yml

data.csv

package.json

opencollection.yml

.gitignore

node_modules

Configuration

You need a package.json file at the root of your Bruno collection.

Open your collection folder in Bruno or in an editor such as VS Code.
Open the integrated terminal (in Bruno or your editor) and go to the collection root:

cd path/to/your/bruno-collection

Initialize package.json:

npm init -y

Install the package (run this in the same terminal, from the collection root):

npm install csv-parse

Confirm csv-parse appears under dependencies in package.json, for example:

"dependencies": {
  "csv-parse": "^6.2.1"
}

Exact versions may differ, but what matters is that the dependency is listed after a successful install.

In Bruno, enable Developer Mode for the collection so require() can load packages from node_modules.

Example: Parse CSV with csv-parse

This example uses csv-parse ^↗ to turn CSV text into JavaScript objects, then sends the first row as JSON on the request. See the npm package page ^↗ for options, streaming APIs, and more. Use a Pre Request script with Developer Mode on:

const { parse } = require('csv-parse/sync');

const csvData = `name,email
Smith,smith@example.com
John,john@example.com`;

const records = parse(csvData, {
  columns: true,
  skip_empty_lines: true
});

req.setHeader('Content-Type', 'application/json');
req.setBody(records[0]);

Bruno Pre Request script using an external library (csv-parse)

records[0] is the first data row as an object (for example { name: 'Smith', email: 'smith@example.com' }) because columns: true uses the first line as headers.

Reading CSV from a file

You can also read a CSV file. Enable Developer Mode so fs and path are available. Place data.csv next to the request .yml file and use __dirname:

const fs = require('fs');
const path = require('path');
const { parse } = require('csv-parse/sync');

const csvData = fs.readFileSync(path.join(__dirname, 'data.csv'), 'utf8');
const records = parse(csvData, {
  columns: true,
  skip_empty_lines: true
});

req.setHeader('Content-Type', 'application/json');
req.setBody(records[0]);

If the file lives at the collection root (or in a shared folder under it), use bru.cwd() instead:

const csvData = fs.readFileSync(path.join(bru.cwd(), 'data.csv'), 'utf8');

__dirname is the directory of the executing file (the request, folder, or collection script). bru.cwd() is always the collection root. See __dirname and __filename.

API Client

Send Requests

Variables

Authentication

Secret Management

Tests

Scripts

Git & Collaboration

AI

Apps

Settings

Debugging

Prerequisites

Project structure

Configuration

Example: Parse CSV with csv-parse

Reading CSV from a file

​Prerequisites

​Project structure

​Configuration

​Example: Parse CSV with csv-parse

​Reading CSV from a file

Prerequisites

Project structure

Configuration

Example: Parse CSV with csv-parse

Reading CSV from a file