iOS与JS交互之UIWebView协议拦截

avatar
奇舞团移动端团队 @奇舞团

级别：★★☆☆☆c
标签：「iOS与JS交互」「OC与JS交互」「UIWebView与JS交互」
作者： Xs·H
审校： QiShare团队

先解释下标题：“iOS与JS交互”。iOS指iOS原生代码（文章只有OC示例），JS指WEB前端（不单指JavaScript），交互指JS调用iOS和iOS调用JS。 通常情况下，iOS与JS可通过四种方式进行交互。作者将通过四篇文章逐一介绍。

本文介绍通过 UIWebView协议拦截的方式实现iOS与JS交互。

一、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 - UIWebViewDelegate

//! UIWebView在每次加载请求前会调用此方法来确认是否加载此请求
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
    
    if ([request.URL.scheme caseInsensitiveCompare:@"jsToOc"] == NSOrderedSame) {
        [self.class showAlertWithTitle:request.URL.host message:request.URL.query cancelHandler:nil];
        return NO;
    }
    
    return YES;
}
  • 实现原理：
    1、JS与iOS约定好jsToOc协议，用作JS在调用iOS时url的scheme；
    2、JS在登录成功后加载含有token数据的url：(jsToOc://loginSucceed?js_tokenString)；
    3、iOS的UIWebView在加载请求前都会调用-webView:shouldStartLoadWithRequest:navigationType:方法来确认是否加载此请求；
    4、iOS在此方法内截取jsToOc协议获取JS传过来的数据，用UIAlertController显示出来，并不允许加载此请求。

PS：除了显示截取到的数据，iOS还可以将request.URL.host看作JS想调用的方法名，将request.URL.query看作该方法的参数集，从而体现出JS调用iOS的概念。

二、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(), ^{
        NSString *jsString = [NSString stringWithFormat:@"ocToJs('loginSucceed', 'oc_tokenString')"];
        [self.webView stringByEvaluatingJavaScriptFromString:jsString];
    });
}
  • 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使用UIWebView的-stringByEvaluatingJavaScriptFromString:方法访问JS；
    2、iOS与JS约定好ocToJs方法，用作iOS在调用JS时的入口方法；
    3、iOS在登录成功后以loginSucceed和oc_tokenString为参数访问ocToJs方法；
    4、JS在ocToJs方法中将iOS传过来的数据显示在div元素中。

PS：UIWebView的-stringByEvaluatingJavaScriptFromString:方法可以执行JavaScript代码。但只有在整个webView加载完成之后-webViewDidFinishLoad:调用此方法才会有响应。比如：我们可以通过如下方式获取JS的标题。

//! UIWebView在每次加载请求完成后会调用此方法
- (void)webViewDidFinishLoad:(UIWebView *)webView {
    
    self.title = [webView stringByEvaluatingJavaScriptFromString:@"document.title"];
}

可从Github获取工程源码

关注我们的途径有：
QiShare(简书)
QiShare(掘金)
QiShare(知乎)
QiShare(GitHub)
QiShare(CocoaChina)
QiShare(StackOverflow)
QiShare(微信公众号)

推荐文章：
W3C规范标准化流程
糖是甜的，你也是: 致async

avatar
文章
阅读
粉丝