Links

Regex (Regular Expression)

Regular Expression

1. What's it?

From the 2.3.0 version, Proxyman supports Wildcard and full-matching Regex (Regular Expression) 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. 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?/*

3. Regex

Proxyman also supports Regex.
  • Make sure your regex is Full Matching the 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.
Make sure your Regex matches whole words
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 .*