impit

impit for JavaScript

This documents the impit Node.JS package, which provides JavaScript bindings for the impit library.

See documentation for the Python version of impit here.

impit is a Node.JS module that provides bindings for the impit library.

It allows you to switch the TLS fingerprints and the HTTP headers of your requests, while still using the same API as the built-in (since Node.JS 18) fetch function.

Installation

npm install impit

Installing the root package (impit) with the package manager of your choice will also install the correct prebuilt binary for your platform.

Compatibility

Usage

import { Impit } from 'impit';

// Set up the Impit instance
const impit = new Impit({
    browser: "chrome", // or "firefox"
    proxyUrl: "http://localhost:8080",
    ignoreTlsErrors: true,
});

// Use the `fetch` method as you would with the built-in `fetch` function
const response = await impit.fetch("https://example.com");

console.log(response.status);
console.log(response.headers);
console.log(await response.text());
// console.log(await response.json());
// ...

// Override redirect behavior per request (default: follows instance-level setting)
const manualResponse = await impit.fetch("https://example.com/login", {
    redirect: "manual", // "follow" | "manual" | "error"
});

if (manualResponse.status === 302) {
    console.log("Redirect to:", manualResponse.headers.get("location"));
}