Breakpoint

How to use the Breakpoint Tool to modify the Request/Response on the fly, including the Headers, URL, Status Code, and the body

1. What's it?

Breakpoint is a handy tool to help developers to edit the content of the Request and Response on the fly.

It's possible to set a breakpoint on both Request or Response.

If you're using Atlantis Framework, you could not use Breakpoint. Please consider using a normal proxy.

2. Main features

Breakpoint tool allows the developer to stop an ongoing Request or incoming Response to modify its data.

• Modify the Request URL, including the Scheme, Host, Path, Port, HTTP Method (Available on Proxyman 2.35.4+)

• Modify HTTP Headers of Request/Response

• Modify Query or Form entry from Requests.

• Modify Authorization/Cookie/Set-Cookie Headers.

• Modify HTTP Body of Request/Response

• Change Response HTTP Status Code.

Breakpoint on Response

Breakpoint on the Request URL (Scheme, Host, Port, Path and Query)

Breakpoint Actions

Action	Meaning
Cancel	Cancel a breakpoint and continue the Request/Response
Abort	Abort the connection and return 503 status code
Execute	Make a request/response with a new change

Check out Breakpoint Tutorial: Breakpoint to intercept and edit the requests/response on iOS app

3. Breakpoint with Raw Message

From build 3.1.0, we can modify the Request / Response by using the Raw Message.

[WIP]

4. Breakpoint by the Scripting Tool ✅

If you would like to do Breakpoint in an Automatic way, you should use the Scripting tools, which you can achieve the same result that Breakpoint can do, but in a flexible way by writing Javascript Code.

Please check out this Snippet Code to understand how to use Scripting for Breakpoint.

5. Breakpoint with GraphQL Requests

From Proxyman 2.27.0+, Breakpoint can work with GraphQL Request by a specific QueryName. Please check out the following GraphQL Document.

GraphQL

6. How to use

You can simply create a Breakpoint rule by:

1. Right-Click on the Request -> Tools -> Breakpoint

2. Proxyman will open a Breakpoint Window and fill the Matching Rule.

3. Select Breakpoint on Request or Response or both.

4. Click Add to create a rule.

5. Try sending a Request again -> Proxyman will open a Breakpoint and you can modify the data.

6. Click on the Execute Button to send a request/response.