persona-http

A blazing-fast HTTP client with TLS fingerprinting for Node.js. Native Rust bindings via napi-rs.

Based on rnet - the original Python implementation.

Installation

npm install persona-http

Usage

Simple GET request

import { get } from 'persona-http'

const response = await get('https://example.com')
const body = await response.text()

Client with browser emulation

import { Client } from 'persona-http'

const client = new Client({
  emulation: 'chrome_133',
})

const response = await client.get('https://google.com')
const body = await response.text()

Override emulation per request

const client = new Client({ emulation: 'chrome_105' })

// Override with different preset
const response = await client.get(url, { emulation: 'chrome_101' })

// Skip client hint headers
const response2 = await client.get(url, {
  emulation: { preset: 'chrome_105', skipHeaders: true },
})

Platform Support

| Platform | Architectures | Node.js | | ------------- | --------------- | ------- | | macOS | x64, arm64 | 20, 22 | | Windows | x64, x86, arm64 | 20, 22 | | Linux (glibc) | x64, arm64 | 20, 22 | | Linux (musl) | x64, arm64 | 20, 22 | | FreeBSD | x64 | 20, 22 | | Android | arm64, armv7 | - |

Development

Requirements:

• Rust (latest stable)
• Node.js 20+
• pnpm

Build and test:

pnpm install
pnpm build
pnpm test

License

MIT