Tests

Docker (recommended)

Since Linux and macOS handle sockets differently, please run tests in a Docker container to have a consistent Linux environment for running tests.

1. Run all tests

   npm run test:docker

2. Run a specific test file

   npm run test:docker test/server.js

3. Run all direct ipv6 test cases across all tests

   npm run test:docker test/server.js -- --grep "direct ipv6"

Note: for test in Docker no changes in /etc/hosts needed.

Local Machine

Prerequisites

1. Node.js 18+ (see .nvmrc for exact version)

2. For MacOS with ARM CPUs install Rosetta (workaround for puppeteer)

3. Update /etc/hosts

   # Used by proxy-chain NPM package tests
   127.0.0.1 localhost
   127.0.0.1 localhost-test

   The localhost entry is for avoiding dual-stack issues, e.g. when the test server listens at ::1 (results of getaddrinfo have specified order) and the client attempts to connect to 127.0.0.1 .

   The localhost-test entry is a workaround to PhantomJS' behavior where it skips proxy servers for localhost addresses.

Run tests

1. Run all tests

   npm run test

2. Run a specific test file

   npm run test test/anonymize_proxy.js