Proxyman
HomepageDownload
  • Overview
  • Changelog
  • License
  • License Manager
  • Raycast
  • Command-line
  • Security Compliance
  • Proxyman iOS
    • Proxyman for iOS
    • Map Local for iOS
    • Breakpoint for iOS
    • Tutorial for iOS
      • Map Local for iOS Tutorial
      • Breakpoint for iOS Tutorial
  • Debug on Devices
    • macOS
    • iOS Device
    • iOS Simulator
    • tvOS & watchOS
    • Android Device & Emulator
      • Automatic Script for Android Emulator
      • Sample Android Project
    • Firefox
    • Java VMs
    • Python
    • Ruby
    • NodeJS
    • Rust
    • Golang
    • React Native
    • Flutter
    • HTTP Clients
    • Docker
    • ElectronJS
    • NextJS (fetch)
  • Automatic Setup
    • Automatic Setup
    • Manual Setup
    • Troubleshooting
  • Atlantis
    • Atlantis for iOS
  • BASIC FEATURES
    • Proxyman Proxy Helper Tool
    • Request / Response Previewer
    • SSL Proxying
    • Bypass Proxy List
    • Import / Export
    • Content Filter
    • Multiple Tabs
    • Horizontal/Vertical/Window Layout
    • Copy as
    • Custom Previewer Tab
    • Custom Header Column
    • Regex (Regular Expression)
    • Filter JSON Response
    • Highlight by Color and Add Comment
    • Import / Export Settings
    • Multipart Form-Data Previewer
    • JSONPath
    • Customize Toolbar
    • Localization
    • Quick Preview
  • ADVANCED FEATURES
    • Repeat
    • Edit & Repeat
    • Compose new Request
    • No Caching
    • Breakpoint
    • Breakpoint Templates
    • Map Local (File)
    • Map Local (Directory)
    • Map Remote
    • External Proxy
    • Save Session
    • Protobuf
    • WebSocket
    • Clear Session
    • Block List
    • Allow List
    • Charles Proxy Converter
    • Custom Certificates
    • GraphQL
    • Network Conditions
    • Multiple Filters
    • Custom Filters
    • Publish to Gist
    • Reverse Proxy
    • Code Generator
    • Diff
    • Access Control
    • DNS Spoofing
    • SOCKS Proxy
    • Swagger OpenAPI
    • TLS Key Logging
  • Proxyman Windows
    • Install Certificate
    • WSL
  • Scripting
    • Scripting
    • async/await Request
    • Addons
    • Built-in JS Libraries
    • Write your own Addons
    • Snippet Code
    • Environment Variables
  • Troubleshooting
    • Proxyman does not work with VPN apps
    • My Remote Devices (iOS/Android) could not connect to Proxyman?
    • iOS 16 and iOS 17 issues
    • SSL Error from HTTPS Request/Response
    • I could not see any requests from my localhost server
    • I could not see any HTTP traffic from my NodeJS, Python, or Ruby scripts
    • *.local requests do not appear on Proxyman
    • I couldn't see any traffics on Proxyman
    • I couldn't see any requests from 3rd-party network libraries
    • [Breakpoint] Modify Request/Response by Raw Message
    • Could not change Proxyman App Icons
    • Lost data after updating Proxyman app?
    • Proxyman consumes too much RAM & unresponsive
Powered by GitBook
On this page
  • 1. What's it?
  • 2. Main features
  • 3. Breakpoint with Raw Message
  • 4. Breakpoint by the Scripting Tool ✅
  • 5. Breakpoint with GraphQL Requests
  • 6. How to use
  1. ADVANCED FEATURES

Breakpoint

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

PreviousNo CachingNextBreakpoint Templates

Last updated 6 months ago

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.

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 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

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 ✅

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.

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.

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

Check out Breakpoint Tutorial:

If you would like to do Breakpoint in an Automatic way, you should use the 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 to understand how to use Scripting for Breakpoint.

Atlantis Framework
Breakpoint to intercept and edit the requests/response on iOS app
GraphQL
Breakpoint on Response
Breakpoint on the Request URL (Scheme, Host, Port, Path and Query)
Snippet Code
Scripting