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?

Image for: 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 🎉)

Image for: 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

  • ✅ Matched: Your URL is matched with your rule.

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

3. Wildcard

Image for: 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

Image for: 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

You can use https://regex101.com/ to verify your Regex that matches the whole text.

Please check the Regex Metacharacters, Operator and Flag from Apple Developer Documents to know which one is supported.

Check https://regex101.com and make sure your Regex is full-matching with the given URL

  • 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 .*

Match a request by Wildcard or Regex
Make sure your Regex matches whole words