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. Test your URL (New feature 🎉)
  • 3. Wildcard
  • 4. Regex
  1. BASIC FEATURES

Regex (Regular Expression)

Regular Expression

PreviousCustom Header ColumnNextFilter JSON Response

Last updated 2 years ago

1. What's it?

From the 2.3.0 version, Proxyman supports Wildcard and Regex (Match a whole word) when you define matching rules for all available tools:

  • Map Local

  • Map Remote

  • Block & Allow List

  • Breakpoints

  • Protocol Buffers (Protobuf)

  • Reverse Proxy

  • Network Throttling

  • ...

It's a handy tool to help you exactly define which requests should trigger the tool.

2. Test your URL (New feature 🎉)

From Proxyman v4.8.0, you can quickly test your Rule (Wildcard / Regex).

  • You can quickly test & play around with your Wildcard/Regex

  • Save time: You don't need to go back and forth to check your URL.

  • Less error-prone.

How to use it?

  1. Open any debugging tools (Breakpoint, Map Local, ...) -> Create a new rule

  2. Click on the "Test your Rule" underline button -> New Window is opened.

  3. Add your Rule and URLs you'd like to check

3. Wildcard

Proxyman supports simple Wildcard characters, which include * and ?

Wildcard

Purpose

*

The asterisk in a wildcard matches any character zero or more times.

?

A question mark matches a single character once.

For instance:

  • http://proxyman.io/v1/*

  • https://myserver.com/v?/*

4. Regex

Proxyman also supports Regex.

  • Make sure your regex is matching a whole URL.

  • Partial Matching is considered as not matching.

  • Make sure you escape characters properly: Splash (/), full-stop (.), etc.

For instance:

Regex
Matched URL Examples

https:\/\/proxyman\.io.*

https://proxyman.io https://proxyman.io/v1/data?id=123 https://proxyman.io/pricing

^(http|https):\/\/www\.google\.com.*

http://www.google.com http://www.google.com/user?id=proxyman https://www.google.com

^(http|https)?:\/\/www\.google\.com\/v[0-9]?\/build\?query=proxyman

http://www.google.com/v1/build?query=proxyman www.google.com/v2/build?query=proxyman

  • Select Regex when creating rules

With regular expressions the meaning of ? and * is different from that of wildcards. The equivalent of wildcard ? is the regex . and the equivalent of wildcard * is the regex .*

Matched: Your URL is matched with your rule.

Not Matched: Your URL doesn't match your rule. You might rewrite your wildcard/Regex rule.

You can use to verify your Regex that matches the whole text.

Please check the from Apple Developer Documents to know which one is supported.

Check and make sure your Regex is full-matching with the given URL

✅
⚠️
https://regex101.com/
Regex Metacharacters, Operator and Flag
https://regex101.com
Match a request by Wildcard or Regex
Make sure your Regex matches whole words