WKWebView中新增了一個(gè)功能，可以對(duì)WebView的內(nèi)容添加一些自定義的過(guò)濾規(guī)則。這個(gè)功能原來(lái)在 Safari Extension 中被引入，從 11 開(kāi)始同樣適用于WKWebView。

使用方法

原理上就是提供一個(gè) JSON 給 WebKit，這個(gè) JSON 包括內(nèi)容的觸發(fā)規(guī)則（trigger）和對(duì)應(yīng)的處理方式（action）。比如：

[{
"trigger": {
"url-filter": ".*" },
"action": {
"type": "make-https"} 
}]

WebKit 會(huì)把攔截規(guī)則編譯成高效的二進(jìn)制碼。使用方法如下：

WKContentRuleListStore.default().compileContentRuleList(
  forIdentifier: "ContentBlockingRules",
 encodedContentRuleList: jsonString) { (contentRuleList, error) in
  if let error = error {
     return
  }
 let configuration = WKWebViewConfiguration()     
 configuration.userContentController.add(ruleList!) 
}

可使用的處理方式：Action

對(duì)應(yīng)的 Action 有以下幾種：

1. block：放棄加載資源，如果該資源已經(jīng)緩存也忽略緩存
2. block-cookies：所有發(fā)送的請(qǐng)求的header中都會(huì)過(guò)濾掉cookie
3. css-display-none：隱藏使用 CSS selector 的頁(yè)面元素，同時(shí)還有關(guān)聯(lián)的selector：

   "action": {
      "type": "css-display-none",
      "selector": "#newsletter, :matches(.main-page, .article) .news-overlay"
   }

4. ignore-previous-rules：前面觸發(fā)的規(guī)則不執(zhí)行
5. make-https：把網(wǎng)頁(yè)里的 http 請(qǐng)求改為 https 請(qǐng)求

規(guī)則觸發(fā)器：trigger

觸發(fā)器必須有url-filter，可選的鍵有：resource-type、if-domain、unless-domain

1. url-filter 匹配 URL 的正則表達(dá)式
2. if-domain 或者 unless-domain if-domain：規(guī)則只在這些域名下起作用。unless-domain：這些域名除外。
3. resource-type 資源的類型，對(duì)應(yīng)的 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 資源的歸屬。默認(rèn)是全部的資源。如果收到填有兩種 value：
   1. first-party 只有當(dāng)資源和頁(yè)面的scheme、域名、端口一致時(shí)才觸發(fā)
   2. third-party 只有當(dāng)資源和頁(yè)面的域名不一致時(shí)才觸發(fā)

舉個(gè) trigger 的示例就是：

"trigger": {
    "url-filter": ".*",
    "resource-type": ["image", "style-sheet"],
    "unless-domain": ["your-content-server.com", "trusted-content-server.com"]
}

總結(jié)

可以通過(guò)配置規(guī)則攔截頁(yè)面里的資源請(qǐng)求、隱藏頁(yè)面里的指定元素、將http請(qǐng)求轉(zhuǎn)換成https。

參考

Content Blocking Rules

WWDC 17：customized_loading_in_wkwebview

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論