iOS與JS交互之WKWebView-協議攔截

 

前言

　　“iOS與JS交互”。iOS指iOS原生代碼（文章只有OC示例），JS指WEB前端（不單指JavaScript），交互指JS調用iOS和iOS調用JS。將iOS與JS交互總結成了6種方式，並將逐一介紹。

目錄如下：

• iOS與JS交互之UIWebView-協議攔截
• iOS與JS交互之UIWebView-JavaScriptCore框架
• iOS與JS交互之UIWebView-JSExport協議
• iOS與JS交互之WKWebView-協議攔截
• iOS與JS交互之WKWebView-WKScriptMessageHandler協議
• iOS與JS交互之WKWebView-WKUIDelegate協議

本文介紹通過 WKWebView協議攔截的方式實現iOS與JS交互。
WKWebView是Apple在iOS8推出的Webkit框架中的負責網頁的渲染與展示的類，相比UIWebView速度更快，占用內存更少，支持更多的HTML特性。

一、JS調用iOS：

• 實現邏輯：點擊JS的登錄按鈕，JS將登錄成功后的token數據傳遞給iOS，iOS將收到的數據展示出來。

• 實現效果：

  
  
  
   

  

  JS調用iOS實現效果

• JS代碼：

//! 登錄按鈕
<button onclick = "login()" style = "font-size: 18px;">登錄</button>
//! 登錄
function login() {
  var token = "js_tokenString";
  loginSucceed(token);
}

//! 登錄成功
function loginSucceed(token) {
  var action = "loginSucceed";
  jsToOc(action, token);
}

//! JS調用OC入口
function jsToOc(action, params) {
  var url = "jsToOc://" + action + "?" + params;
  loadURL(url);
}

//! 加載URL
function loadURL(url) {
  window.location.href = url;
}

• iOS代碼：

#pragma mark - WKNavigationDelegate

//! WKWeView在每次加載請求前會調用此方法來確認是否進行請求跳轉
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {
    
    if ([navigationAction.request.URL.scheme caseInsensitiveCompare:@"jsToOc"] == NSOrderedSame) {
        [WKWebViewInterceptController showAlertWithTitle:navigationAction.request.URL.host message:navigationAction.request.URL.query cancelHandler:nil];
        decisionHandler(WKNavigationActionPolicyCancel);
    }
    else {
        decisionHandler(WKNavigationActionPolicyAllow);
    }
}

• 實現原理：
  1、JS與iOS約定好jsToOc協議，用作JS在調用iOS時url的scheme；
  2、JS在登錄成功后加載含有token數據的url：(jsToOc://loginSucceed?js_tokenString)；
  3、iOS的WKWebView在請求跳轉前會調用-webView:decidePolicyForNavigationAction:decisionHandler:方法來確認是否允許跳轉；
  4、iOS在此方法內截取jsToOc協議獲取JS傳過來的數據，用UIAlertController顯示出來，並通過decisionHandler不允許此請求跳轉。

PS1：除了顯示截取到的數據，iOS還可以將navigationAction.request.URL.host看作JS想調用的方法名，將navigationAction.request.URL.query看作該方法的參數集，從而體現出JS調用iOS的概念。

PS2：在-webView:decidePolicyForNavigationAction:decisionHandler:方法中一定要調用decisionHandler回調來制定允許請求跳轉WKNavigationActionPolicyAllow或者不允許跳轉WKNavigationActionPolicyAllow，不然會崩潰。

---

二、iOS調用JS：

• 實現邏輯：點擊iOS的登錄按鈕，iOS將登錄成功后的token數據傳遞給JS，JS將收到的數據展示出來。

• 實現效果：

  
  
  
  
   

  

  iOS調用JS實現效果

• iOS代碼：

//! 登錄按鈕
UIBarButtonItem *loginBtnItem = [[UIBarButtonItem alloc] initWithTitle:@"登錄" style:UIBarButtonItemStylePlain target:self action:@selector(login:)];
self.navigationItem.rightBarButtonItems = @[loginBtnItem];
//! 登錄方法
- (void)login:(id)sender {
    
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        [self.webView evaluateJavaScript:@"ocToJs('loginSucceed', 'oc_tokenString')" completionHandler:^(id response, NSError *error) {}];
    });
}

• JS代碼：

//! iOS調用JS入口
function ocToJs(action, params) {
  document.getElementById("returnValue").innerHTML = action + '?' + params;
}
//! iOS調用JS數據顯示框
<div id = "returnValue" style = "font-size: 18px; border: 1px dotted; height: 50px;"> </div>

• 實現原理：
  1、iOS與JS約定好ocToJs方法，用作iOS在調用JS時的入口方法；
  2、iOS在登錄成功后以loginSucceed和oc_tokenString為參數拼接JS代碼ocToJs('loginSucceed', 'oc_tokenString');
  3、iOS使用WKWebView的-evaluateJavaScript:completionHandler:方法執行拼接好的JS代碼；
  3、JS在ocToJs方法中將iOS傳過來的數據顯示在div元素中；
  4、iOS通過completionHandler收到JS中ocToJs方法的回調。

PS1：WKWebView的-evaluateJavaScript:completionHandler:方法可以執行JS代碼。但只有在整個webView加載完成之后調用此方法才會有響應。比如：我們可以通過如下方式獲取JS的標題。

PS2:  對於oc而言，如果我們約定要給H5傳一個字符串作為參數的話，注意這個字符串要加上引號，例如我直接將@"XLH5SDKbackground"作為字符串傳給H5,那么到了H5那邊，將會認為你傳過來的只是一個object（對象）而不是一個字符串，因此，**要將這個字符串加上一對單引號（'XLH5SDKbackground'）**就不會有這個錯了。

PS3:獲取工程源碼

//! WKWebView在每次加載請求完成后會調用此方法
- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {
    [webView evaluateJavaScript:@"document.title" completionHandler:^(NSString *title, NSError *error) {
        self.title = title;
    }];
}