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

Operating System	Architecture	libc implementation	Prebuilt binaries available
Linux	x86_64	glibc	✅
Linux	x86_64	musl	✅
Linux	arm64	glibc	✅
Linux	arm64	musl	✅
macOS	x86_64	N/A	✅
Windows	x86_64	N/A	✅
macOS	arm64	N/A	✅
Windows	arm64	N/A	✅

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"));
}