iOS11 WKWebView内容过滤规则详解

2025-05-29 0 98

WKWebView中新增了一个功能,可以对WebView的内容添加一些自定义的过滤规则。这个功能原来在 Safari Extension 中被引入,从 11 开始同样适用于WKWebView

使用方法

原理上就是提供一个 JSON 给 WebKit,这个 JSON 包括内容的触发规则(trigger)和对应的处理方式(action)。比如:

?

1

2

3

4

5

6
[{

"trigger": {

"url-filter": ".*" },

"action": {

"type": "make-https"}

}]

WebKit 会把拦截规则编译成高效的二进制码。使用方法如下:

?

1

2

3

4

5

6

7

8

9
WKContentRuleListStore.default().compileContentRuleList(

forIdentifier: "ContentBlockingRules",

encodedContentRuleList: jsonString) { (contentRuleList, error) in

if let error = error {

return

}

let configuration = WKWebViewConfiguration()

configuration.userContentController.add(ruleList!)

}

可使用的处理方式:Action

对应的 Action 有以下几种:

  1. block:放弃加载资源,如果该资源已经缓存也忽略缓存
  2. block-cookies:所有发送的请求的header中都会过滤掉cookie
  3. css-display-none:隐藏使用 CSS selector 的页面元素,同时还有关联的selector:

    ?

    1

    2

    3

    4
    "action": {

    "type": "css-display-none",

    "selector": "#newsletter, :matches(.main-page, .article) .news-overlay"

    }

  4. ignore-previous-rules:前面触发的规则不执行
  5. make-https:把网页里的 http 请求改为 https 请求

规则触发器:trigger

触发器必须有url-filter,可选的键有:resource-type、if-domain、unless-domain

  1. url-filter 匹配 URL 的正则表达式
  2. if-domain 或者 unless-domain if-domain:规则只在这些域名下起作用。unless-domain:这些域名除外。
  3. resource-type 资源的类型,对应的 value 有:

    1. document
    2. image
    3. style-sheet
    4. script
    5. font
    6. raw (Any untyped load, such as XMLHttpRequest)
    7. svg-document
    8. media
    9. popup
  4. load-type 资源的归属。默认是全部的资源。如果收到填有两种 value:

    1. first-party 只有当资源和页面的scheme、域名、端口一致时才触发
    2. third-party 只有当资源和页面的域名不一致时才触发

举个 trigger 的示例就是:

?

1

2

3

4

5
"trigger": {

"url-filter": ".*",

"resource-type": ["image", "style-sheet"],

"unless-domain": ["your-content-server.com", "trusted-content-server.com"]

}

总结

可以通过配置规则拦截页面里的资源请求、隐藏页面里的指定元素、将http请求转换成https。

参考

Content Blocking Rules

WWDC 17:customized_loading_in_wkwebview

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持快网idc。

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

快网idc优惠网 建站教程 iOS11 WKWebView内容过滤规则详解 https://www.kuaiidc.com/90657.html

相关文章

发表评论
暂无评论