匹配原则
whistle的协议比较多,具体参见:协议列表,这些协议的匹配优先级及同时可匹配规则个数遵循以下四个原则:
相同协议规则的默认优先级从上到下,即前面的规则优先级匹配高于后面,如:
www.test.com 127.0.0.1:9999 www.test.com/xxx 127.0.0.1:8080
请求
https://www.test.com/xxx/index.html
按从上到下的匹配顺序,只会匹配www.test.com 127.0.0.1:9999
,这个与传统的hosts配置后面优先的顺序相反。如果想跟系统hosts匹配顺序一致,可以在界面通过
Rules -> Settings -> Back rules first
修改,但这个规则只对在页面里面配置的规则生效,对插件里面自带的规则及通过@方式内联的远程规则不生效。- 除rule及proxy对应规则除外,可以同时匹配不同协议的规则
请求www.test.com 127.0.0.1:9999 www.test.com/xxx 127.0.0.1:8080 www.test.com proxy://127.0.0.1:8888 www.test.com/xxx socks://127.0.0.1:1080 www.test.com pac://http://www.pac-server.com/test.pac www.test.com/xxx http://www.abc.com www.test.com file:///User/xxx/test
https://www.test.com/xxx/index.html
按从上到下的匹配顺序,及第二点原则,会匹配以下规则:www.test.com 127.0.0.1:9999 www.test.com proxy://127.0.0.1:8888 www.test.com pac://http://www.pac-server.com/test.pac www.test.com/xxx http://www.abc.com
proxy、http-proxy、https-proxy、socks都属于proxy,html、file等都属于rule,所以这两个对应的协议只能各种匹配其中优先级最高的一个。
- 一些属于不同协议,但功能有冲突的规则,如 rule、host、proxy,按常用优先级为
rule > host > proxy
,如:
上述同时匹配file、host、proxy,但只会执行本地替换file。www.test.com 127.0.0.1:9999 www.test.com/xxx 127.0.0.1:8080 www.test.com proxy://127.0.0.1:8888 www.test.com/xxx socks://127.0.0.1:1080 www.test.com file:///User/xxx/test www.test.com/xxx http://www.abc.com
- 部分相同协议会匹配及合并所有可以匹配的规则,如:
请求www.test.com 127.0.0.1:9999 www.test.com/xxx 127.0.0.1:8080 www.test.com proxy://127.0.0.1:8888 www.test.com/xxx socks://127.0.0.1:1080 www.test.com pac://http://www.pac-server.com/test.pac www.test.com/xxx http://www.abc.com www.test.com file:///User/xxx/test www.test.com/xxx reqHeaders://{test.json} www.test.com reqHeaders:///User/xxx/test.json www.test.com/xxx htmlAppend:///User/xxx/test.html www.test.com htmlAppend://{test.html} www.test.com/xxx reqHeaders:///User/xxx/test2.json www.test.com htmlAppend://{test2.html}
https://www.test.com/xxx/index.html
会匹配以下规则:
其中,所有匹配的reqHeaders协议的规则会将其对应的json合并后再合并到请求headers里,而所有匹配htmlAppend的html内容会通过换行符www.test.com 127.0.0.1:9999 www.test.com proxy://127.0.0.1:8888 www.test.com pac://http://www.pac-server.com/test.pac www.test.com/xxx http://www.abc.com www.test.com/xxx reqHeaders://{test.json} www.test.com reqHeaders:///User/xxx/test.json www.test.com/xxx htmlAppend:///User/xxx/test.html www.test.com htmlAppend://{test.html} www.test.com/xxx reqHeaders:///User/xxx/test2.json www.test.com htmlAppend://{test2.html}
\n
合并并追加到响应的html内容里面,其它可以合并的协议如下(主要涉及json、注入内容、属性设置对应的协议):- ignore
- enable
- filter
- disable
- plugin
- delete
- urlParams
- params
- reqHeaders
- resHeaders
- reqCors
- resCors
- reqCookies
- resCookies
- reqReplace
- urlReplace
- resReplace
- resMerge
- reqBody
- reqPrepend
- resPrepend
- reqAppend
- resAppend
- resBody
- htmlAppend
- jsAppend
- cssAppend
- htmlBody
- jsBody
- cssBody
- htmlPrepend
- jsPrepend
- cssPrepend