Choose how you want to run

HTTP Toolbox

A testing harness for exercising intercepting proxies and VPN clients across a fixed set of browser-based tests. Validate how your proxy handles headers, cookies, request/response sizes, and edge cases.

Run in the Browser

Open the test pages directly. Use your system/browser proxy settings to point at the target proxy.

Open Test List

Completion Page

Static completion screen shown when all tests finish in the redirect-based flow.

View Completion

CLI Quick Reference

Start local server: python local_server.py (defaults to http://127.0.0.1:3000)
Run all tests: python local_runner.py http://127.0.0.1:3000
Run through proxy: python local_runner.py http://127.0.0.1:3000 --proxy http://proxy:port
Enable TLS validation: add --verify-ssl
Filter tests: --tests 01_basic_load 02_headers

What Gets Tested

The test suite covers core HTTP scenarios that intercepting proxies must handle correctly:

Connectivity – Basic load, IP detection, payload generation
Headers – Custom headers pass through unchanged, edge cases with long/special headers
Cookies – Server and client-side cookie creation, verification, special formats
Request Sizes – Large request bodies, POST handling, form encoding
Response Sizes – Large response bodies, streaming, chunked transfers
URL Handling – Long URLs, encoded characters, query string edge cases
Concurrent Requests – Background fetch, load testing with many parallel requests
Content Types – Text rendering, video embeds, third-party resources