| description |
|---|
Regular Expression |
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.
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.
- Open any debugging tools (Breakpoint, Map Local, ...) -> Create a new rule
- Click on the "Test your Rule" underline button -> New Window is opened.
- 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.
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:
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 |
| ^(http|https):\/\/www\.google\.com.* | http://www.google.com |
| ^(http|https)?:\/\/www\.google\.com\/v[0-9]?\/build\?query=proxyman | http://www.google.com/v1/build?query=proxyman |
You can use https://regex101.com/ to verify your Regex that matches the whole text.
{% hint style="info" %} Please check the Regex Metacharacters, Operator and Flag from Apple Developer Documents to know which one is supported. {% endhint %}
{% hint style="info" %} Check https://regex101.com and make sure your Regex is full-matching with the given URL {% endhint %}
- Select Regex when creating rules
{% hint style="info" %}
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 .*
{% endhint %}