Appearance
URL重写 replace
- search: _ #搜索参数
replace: '' #替换参数
在开始之前
ClientWorker
作为浏览器中间件,将会在Request
发送到服务器之前对url
进行转换。这种转换是存在于ServiceWorker
层面,对于用户来说处于黑盒。url的重写在用户层面观察是不会发生变动的。
用一个不恰当的类比就是相当于隐形转发。如果你要显性跳转,请使用Redirect
规则。
单路由重写
这是一个简单的例子,用于移除url中的所有搜索参数,对于纯静态网站,这个规则很有用
- search: \?.*
replace: ''
https://example.com
无匹配https://example.com?q=1
匹配?q=1
这里还有一个较难的例子,用于为/path/
重写到/path/index.html
,对于使用对象存储等没有自定义路由规则的第三方存储作为博客的用户可能比较有帮助:
- search: ([^\/.]+)\/$
replace: $1/index.html
$1
表示搜索规则搜索到的第一个匹配结果,这里应该是/path/
。这属于正则内容,这里不再阐述。
并发重写
这种操作类比于freecdn
的自动选择公共库
功能,也是通过多个资源同时并发挑选最快的响应。
这是一个将jsdelivr
的所有npm流量并发的例子,这个规则对于中国大陆用户来说比较友好:
- search: ^https:\/\/(cdn|fastly|test1|gcore)\.jsdelivr\.net\/npm\/
replace:
- https://npm.elemecdn.com/
- https://unpkg.com/
- https://unpkg.zhimg.com/
- _
在
replace
为数组时,你可以用_
来表示将原请求也给并发
replace
只会将url
重写,对于其它内容将不会修改。
需要注意的是,如果你已经将url重写为并发,那么接下来重写功能将失效;如果上述规则已经
fetch
过,那么tReq
将会转化为tRes
,之后重写功能也会失效。但是重写依旧会对原url(尽管不在用于请求)造成影响,可能会被接下来的规则捕捉。
参数
search
: 搜索规则,在searchin
的范围内(默认是url
)搜索匹配的内容,正则语法。searchin
: 搜索范围,可以是url
、header
、body
、status
、statusText
,默认是url
。searchkey
: 在搜索header
时,必须要指定searchkey
为搜索键。searchflags
: 搜索正则修饰,可以是i
、g
、m
、s
,默认为空。对search
的修饰replace
: 重写规则,在replacein
的范围内(默认是url
)搜索匹配的内容,正则语法。replacein
: 重写范围,可以是url
、header
、body
、status
、statusText
,默认是url
。replacekey
: 优先重写replacekey
作为待替换词,如果没有,则回退到search
,避免search
无法替换不同范围内的内容,正则语法。replaceflags
: 重写正则修饰,可以是i
、g
、m
、s
,默认为空。 对replacekey
或search
的修饰
目前对于body的搜索仅支持文本搜索,请不要用于搜索二进制数据,否则将会导致返回数据异常。
对于header的搜索,
headerkey
是不敏感大小写的