iOS11 WKWebView内容过滤规则详解

时间:2021-05-02

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 有以下几种:

  • block:放弃加载资源,如果该资源已经缓存也忽略缓存
  • block-cookies:所有发送的请求的header中都会过滤掉cookie
  • css-display-none:隐藏使用 CSS selector 的页面元素,同时还有关联的selector: ? 1 2 3 4 "action": { "type": "css-display-none", "selector": "#newsletter, :matches(.main-page, .article) .news-overlay" }

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

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

  • url-filter 匹配 URL 的正则表达式
  • if-domain 或者 unless-domain if-domain:规则只在这些域名下起作用。unless-domain:这些域名除外。
  • resource-type 资源的类型,对应的 value 有:
  • document
  • image
  • style-sheet
  • script
  • font
  • raw (Any untyped load, such as XMLHttpRequest)
  • svg-document
  • media
  • popup
  • load-type 资源的归属。默认是全部的资源。如果收到填有两种 value:
  • first-party 只有当资源和页面的scheme、域名、端口一致时才触发
  • 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

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

    原文链接:http://www.jianshu.com/p/8af24e9dc82e

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章