Havelock

Havelock is a simple Node package capable of extracting data such as logins, cookies, and URLs from Chromium-based web browsers such as Google Chrome.

Installation

The module can be installed via Yarn with one command:

yarn add havelock.js

That’s it, get started using the section below.

Usage

Havelock provides a simple API that is easy to use, you can for example extract logins from Google Chrome using this code:

const havelock = require("havelock.js");

havelock
  .getData("chrome", "Default", "Login Data")
  .then(value => {
    console.log(value);
  })
  .catch(reason => {
    console.log(reason);
  });

This code assumes that Google Chrome is installed, your profile is Default, and data exists in the file Login Data.

There are also short-hand methods based on files of interest, like:

const havelock = require("havelock.js");

havelock
  .getLoginData("chrome", "Default")
  .then(value => {
    console.log(value);
  })
  .catch(reason => {
    console.log(reason);
  });

Supported Web Browsers

Havelock supports all Chromium-based web browsers that use the user data directory for storing user data.

These are supported out of the box:

| Name | Identifier | Platform(s) | | -------------------- | --------------- | --------------------- | | Chromium | chromium | Windows, macOS, Linux | | Google Chrome | chrome | Windows, macOS, Linux | | Google Chrome Beta | chrome-beta | Linux | | Google Chrome Canary | chrome-canary | Windows, macOS | | Google Chrome Dev | chrome-dev | Linux |

If your web browser isn’t listed here, you can use the getDataFromPath() function. You need to know the full path to the file and which table to access.

License

MIT License