mirror of
https://github.com/cypress-io/cypress.git
synced 2026-05-03 13:30:26 -05:00
Zach Bloomquist
38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
# proxy
|
|
|
|
This package contains the code for Cypress's HTTP interception proxy.
|
|
|
|
## HTTP interception
|
|
|
|
[`./lib/http`](./lib/http) contains the code that intercepts HTTP requests. The bulk of the proxy's behavior is in three files:
|
|
|
|
* [`request-middleware.ts`](./lib/http/request-middleware.ts) contains code that manipulates HTTP requests from the browser
|
|
* [`response-middleware.ts`](./lib/http/responseest-middleware.ts) contains code that manipulates HTTP responses to the browser
|
|
* [`error-middleware.ts`](./lib/http/responseest-middleware.ts) handles errors that occur in the request/response cycle
|
|
|
|
## Building
|
|
|
|
Note: you should not ever need to build the .js files manually. `@packages/ts` provides require-time transpilation when in development.
|
|
|
|
```shell
|
|
yarn workspace @packages/proxy build-prod
|
|
```
|
|
|
|
## Testing
|
|
|
|
Tests are located in [`./test`](./test)
|
|
|
|
To run tests:
|
|
|
|
```shell
|
|
yarn workspace @packages/proxy test
|
|
```
|
|
|
|
Additionally, the `server` package contains tests that use the `proxy`.
|
|
|
|
## Debug Logs
|
|
|
|
High level logs are available in the `DEBUG=cypress:proxy:*` namespace.
|
|
|
|
Detailed per-request logs are available in `DEBUG=cypress-verbose:proxy:http`.
|