README.md

testcafe-hammerhead

testcafe-hammerhead is a powerful Web proxy used as a core for the TestCafe testing framework.

Core Concepts

testcafe-hammerhead is a URL-rewriting proxy. This means that it rewrites all properties of the appropriate JavaScript objects that contain a URL value (Location, HTMLLinkElement.href, etc). You can see it if you open a proxied page, invoke the browser's DevTools and inspect any element.

In addition, the proxied web page does not know that it is opened under a proxy. The proxy intercepts access attempts to all URL-containing properties and provides the original values.

First Look

1. Clone the Hammerhead repository

   git clone https://github.com/DevExpress/testcafe-hammerhead.git

2. Go to the testcafe-hammerhead folder

   cd testcafe-hammerhead

3. Install the dependencies

   npm install

4. Run the Hammerhead playground to see our proxy in action

   node node_modules/gulp/bin/gulp http-playground

This opens a playground page where you can specify a webpage to proxy. Enter the page URL and hit Proxy!.

Features

• HTTP/HTTPS requests
• WebSockets, EventSource
• file upload
• request events (onRequest, onResponse)
• bypassing requests
• custom UI on a web page

Reporting Issues and Contributing

Read our Contributing Guide to learn how to contribute to the project.