Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 3.09 KB

breakpoint.md

File metadata and controls

77 lines (51 loc) · 3.09 KB
Raw
description
How to use the Breakpoint Tool to modify the Request/Response on the fly, including the Headers, URL, Status Code, and the body

Breakpoint

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.

{% hint style="info" %} If you're using Atlantis Framework, you could not use Breakpoint. Please consider using a normal proxy. {% endhint %}

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

{% hint style="info" %} Check out Breakpoint Tutorial: Breakpoint to intercept and edit the requests/response on iOS app {% endhint %}

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.

{% content-ref url="graphql.md" %} graphql.md {% endcontent-ref %}

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.