iOS JavaScriptCore使用

JavaScriptCore是apple推出的为了解决ios与js交互的框架,功能强大而实用。

JavaScriptCore中主要的类

1、JSContext --- 在OC中创建JavaScript运行的上下文环境

 - (instancetype)init; // 创建JSContext对象,获得JavaScript运行的上下文环境

 // 在特定的对象空间上创建JSContext对象,获得JavaScript运行的上下文环境
 - (instancetype)initWithVirtualMachine:(JSVirtualMachine *)virtualMachine;

 // 运行一段js代码,输出结果为JSValue类型
 - (JSValue *)evaluateScript:(NSString *)script;

 // iOS 8.0以后可以调用此方法
 - (JSValue *)evaluateScript:(NSString *)script withSourceURL:(NSURL *)sourceURL NS_AVAILABLE(10_10, 8_0);

 // 获取当前正在运行的JavaScript上下文环境
 + (JSContext *)currentContext;

 // 返回结果当前执行的js函数 function () { [native code] } ,iOS 8.0以后可以调用此方法
  + (JSValue *)currentCallee NS_AVAILABLE(10_10, 8_0);

  // 返回结果当前方法的调用者[object Window]
  + (JSValue *)currentThis;

  // 返回结果为当前被调用方法的参数
  + (NSArray *)currentArguments;

  // js的全局变量 [object Window]
  @property (readonly, strong) JSValue *globalObject;

2、JSValue --- JavaScript中的变量和方法,可以转成OC数据类型,每个JSValue都和JSContext相关联并且强引用context

   oc与js类型对照:
      @textblock
     Objective-C type  |   JavaScript type
   --------------------+---------------------
           nil         |     undefined
          NSNull       |        null
         NSString      |       string
         NSNumber      |   number, boolean
       NSDictionary    |   Object object
         NSArray       |    Array object
          NSDate       |     Date object
         NSBlock (1)   |   Function object (1)
            id (2)     |   Wrapper object (2)
          Class (3)    | Constructor object (3)
      @/textblock

  //此方法会转换self为JS对象,但是self中必须实现指定的方法和协议
  + (JSValue *)valueWithObject:(id)value inContext:(JSContext *)context;

  // 在context创建BOOL的JS变量
  + (JSValue *)valueWithBool:(BOOL)value inContext:(JSContext *)context;

  // 将JS变量转换成OC中的BOOL类型
  - (BOOL)toBool;

  // 修改JS对象的属性的值
  - (void)setValue:(id)value forProperty:(NSString *)property;

  // JS中是否有这个对象
  @property (readonly) BOOL isUndefined;

  // 比较两个JS对象是否相等
  - (BOOL)isEqualToObject:(id)value;

  // 调用者JSValue为JS中的方法,arguments为参数,执行调用者JSValue,并传递参数arguments,@[@"a",@"b"@"c"]
  - (JSValue *)callWithArguments:(NSArray *)arguments;

 // 调用者JSValue为JS中的全局对象名称,method为全局对象的方法名称,arguments为参数
  - (JSValue *)invokeMethod:(NSString *)method withArguments:(NSArray *)arguments;

 // JS中的结构体类型转换为OC
  + (JSValue *)valueWithPoint:(CGPoint)point inContext:(JSContext *)context;
JSExport --- JS调用OC中的方法和属性写在继承自JSExport的协议当中,OC对象实现自定义的协议
 // textFunction -- JS方法
 // - (void) ocTestFunction:(NSNumber *)value sec:(NSNumber *)number -- OC方法
 JSExportAs (textFunction,- (void) ocTestFunction:(NSNumber *)value sec:(NSNumber *)number);
JSManagedValue --- JS和OC对象的内存管理辅助对象,主要用来保存JSValue对象,解决OC对象中存储js的值,导致的循环引用问题

 JSManagedValue *_jsManagedValue = [JSManagedValue managedValueWithValue:jsValue];
[_context.virtualMachine addManagedReference:_jsManagedValue];
JSManagedValue本身只弱引用js值,需要调用JSVirtualMachine的addManagedReference:withOwner:把它添加到JSVirtualMachine中,这样如果JavaScript能够找到该JSValue的Objective-C owner,该JSValue的引用就不会被释放。
JSVirtualMachine --- JS运行的虚拟机,有独立的堆空间和垃圾回收机制,运行在不同虚拟机环境的JSContext可以通过此类通信。

下面记录一下使用方法:

一、简单的情况,JS中,点击事件直接调用方法方式

1.1 JS代码如下:

<!DOCTYPE html>
<html>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta content="width=device-width,initial-scale=1,user-scalable=no" name="viewport">

<body style="background-color: white;">
    <script type="text/javascript">
        var nativeCallJS = function(parameter) {
            alert (parameter);
        };
    </script>
    <button type="button" onclick = "jsCallNative('jsParameter')" style="width:100%; height:30px;"/>调用OC代码</button>
</body>
</html>

1.2 oc代码如下:

- (void)doSomeJsThings{
    
    self.jsContext = [_webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
    self.jsContext.exceptionHandler = ^(JSContext *context, JSValue *exception) {
        NSLog(@"出现异常,异常信息:%@",exception);
    };
    
    //oc调用js
    JSValue * nativeCallJS = self.jsContext[@"nativeCallJS"];
    [nativeCallJS callWithArguments:@[@"hello word"]];//调用了js中方法"nativeCallJS",并且传参数@"hello word"
    
    //在本地生成js方法,供js调用
    self.jsContext[@"jsCallNative"] = ^(NSString *paramer){
        JSValue *currentThis = [JSContext currentThis];
        JSValue *currentCallee = [JSContext currentCallee];
        NSArray *currentParamers = [JSContext currentArguments];
        dispatch_async(dispatch_get_main_queue(), ^{
            /**
             *  js调起OC代码,代码在子线程,更新OC中的UI,需要回到主线程
             */
            NSLog(@"js传过来:%@",paramer);
        });
        NSLog(@"JS paramer is %@",paramer);
        NSLog(@"currentThis is %@",[currentThis toString]);
        NSLog(@"currentCallee is %@",[currentCallee toString]);
        NSLog(@"currentParamers is %@",currentParamers);
    };//生成native的js方法,方法名:@"jsCallNative",js可直接调用此方法
}
2017-11-15 13:30:37.715810+0800 WebView+image[2940:337555] js传过来:jsParameter
2017-11-15 13:30:37.715759+0800 WebView+image[2940:337892] JS paramer is jsParameter
2017-11-15 13:30:37.716007+0800 WebView+image[2940:337892] currentThis is [object Window]
2017-11-15 13:30:37.716337+0800 WebView+image[2940:337892] currentCallee is function () {
    [native code]
}
2017-11-15 13:30:37.716743+0800 WebView+image[2940:337892] currentParamers is (
    jsParameter
)

以上就是简单的调用。

二、复杂调用,JS中,点击事件等事件通过调用全局对象的方法调用方法,JS和Native代码的互调如下:

2.1 JS代码如下:

<!DOCTYPE html>
<html>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta content="width=device-width,initial-scale=1,user-scalable=no" name="viewport">
<body style="background-color: white;">

    <script type="text/javascript">
        globalObject = new Object();
        globalObject.name = 100;
        globalObject.nativeCallJS = function (parameter) {
            alert (parameter);
        };
    </script>
    
    <button type="button" onclick = "NativeObject.jsCallNative()" style="width:100%; height:30px;"/>调用OC代码</button>
    <button type="button" onclick = "NativeObject.shareString('jsParameter')" style="width:100%; height:30px;"/>调用OC代码并传参数</button>
</body>
</html>

2.2 oc代码如下:

//声明的协议,当前viewController必须遵守
@protocol JSObjcDelegate <JSExport>

- (void)jsCallNative;
- (void)shareString:(NSString *)shareString;

@end

//方法实现,在webViewDidFinishLoad中调用
- (void)doSomeJsThings{
    
    self.jsContext = [_webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
    self.jsContext.exceptionHandler = ^(JSContext *context, JSValue *exception) {
        NSLog(@"出现异常,异常信息:%@",exception);
    };
    
    //oc调用js
    JSValue * jsObj = self.jsContext[@"globalObject"];//拿到js中要调用方法的全局对象
    //jsObj执行其方法nativeCallJS
    JSValue * returnValue = [jsObj invokeMethod:@"nativeCallJS" withArguments:@[@"hello word"]];
   //调用了js中方法"nativeCallJS",并且传参数@"hello word",这里returnValue是调用之后的返回值,可能为nil
    NSLog(@"returnValue:%@",returnValue);
    
    //写法1
    JSValue * jsCallNative = [JSValue valueWithObject:self inContext:self.jsContext];//此方法会转换self为JS对象,但是self中必须实现指定的方法和协议
    self.jsContext[@"NativeObject"] = jsCallNative;
    //写法2
    //self.jsContext[@"NativeObject"] = self;
    //注:写法1和写法2效果相同,推荐写法1,毕竟系统方法
}

- (void)jsCallNative{//在本地生成js方法,供js调用
    
    JSValue *currentThis = [JSContext currentThis];
    JSValue *currentCallee = [JSContext currentCallee];
    NSArray *currentParamers = [JSContext currentArguments];
    dispatch_async(dispatch_get_main_queue(), ^{
        /**
         *  js调起OC代码,代码在子线程,更新OC中的UI,需要回到主线程
         */
    });
    NSLog(@"currentThis is %@",[currentThis toString]);
    NSLog(@"currentCallee is %@",[currentCallee toString]);
    NSLog(@"currentParamers is %@",currentParamers);
    
}


- (void)shareString:(NSString *)shareString{//在本地生成js方法,供js调用
    
    JSValue *currentThis = [JSContext currentThis];
    JSValue *currentCallee = [JSContext currentCallee];
    NSArray *currentParamers = [JSContext currentArguments];
    dispatch_async(dispatch_get_main_queue(), ^{
        /**
         *  js调起OC代码,代码在子线程,更新OC中的UI,需要回到主线程
         */
        NSLog(@"js传过来:%@",shareString);
    });
    NSLog(@"JS paramer is %@",shareString);
    NSLog(@"currentThis is %@",[currentThis toString]);
    NSLog(@"currentCallee is %@",[currentCallee toString]);
    NSLog(@"currentParamers is %@",currentParamers);
}

打印的log:

2017-11-15 14:02:18.695352+0800 WebView+image[3257:377010] currentThis is [object SecondViewController]
2017-11-15 14:02:18.695745+0800 WebView+image[3257:377010] currentCallee is function () {
    [native code]
}
2017-11-15 14:02:18.695936+0800 WebView+image[3257:377010] currentParamers is (
)
2017-11-15 14:02:50.904847+0800 WebView+image[3257:376893] js传过来:jsParameter
2017-11-15 14:02:50.904842+0800 WebView+image[3257:377010] JS paramer is jsParameter
2017-11-15 14:02:50.905124+0800 WebView+image[3257:377010] currentThis is [object SecondViewController]
2017-11-15 14:02:50.905607+0800 WebView+image[3257:377010] currentCallee is function () {
    [native code]
}
2017-11-15 14:02:50.906052+0800 WebView+image[3257:377010] currentParamers is (
    jsParameter
)

三,特殊要求

3.1 、JS中对象已经生成,需要OC生成对应的方法实现,JS去调用
JS代码如下:

<!DOCTYPE html>
<html>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta content="width=device-width,initial-scale=1,user-scalable=no" name="viewport">
<body style="background-color: white;">
    <script type="text/javascript">
        globalObject = new Object();
        globalObject.name = 100;
        globalObject.nativeCallJS = function (parameter) {
            alert (parameter);
        };
    
        var callBack = function(parameter){
            alert(parameter);
        }
    </script>
    
    <button type="button" onclick = "NativeObject.jsCallNative()" style="width:100%; height:30px;"/>调用OC代码</button>
    <button type="button" onclick = "NativeObject.shareString('jsParameter')" style="width:100%; height:30px;"/>调用OC代码并传参数</button>
    <button type="button" onclick = "globalObject.creatJSMethod('jsParameter')" style="width:100%;height:30px;"/>oc生成JS方法</button>
</body>
</html>

以上JS中globalObject对象已经存在,但是在没有实现creatJSMethod方法,在按钮"oc生成JS方法"却调用了此方法。
OC代码:

- (void)doSomeJsThings{
    
    self.jsContext = [_webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
    self.jsContext.exceptionHandler = ^(JSContext *context, JSValue *exception) {
        NSLog(@"出现异常,异常信息:%@",exception);
    };
    
    //oc调用js
    JSValue * jsObj = self.jsContext[@"globalObject"];//拿到JS中已经存在的对象
    //为jsObj对应的方法提供方法实现
    jsObj[@"creatJSMethod"] = ^(NSString * parameter){
        NSLog(@"方法生成成功:%@",parameter);
    };
  }

log:

2017-11-15 14:47:08.126160+0800 WebView+image[3661:435044] 方法生成成功:jsParameter

3.2、oc重写js本地的方法,与生成一样,上面的代码:

 jsObj[@"creatJSMethod"] = ^(NSString * parameter){
    NSLog(@"方法生成成功:%@",parameter);
 };

既能生成,也能重写。

这些基本就是全部的情况了,当然还有一些线程问题等,等有需要再总结。

总结:

oc与js交互,先看js是调oc还是oc调用js,再看js中方法是全局方法还是全局属性方法(可能说的不是很准确)。清楚了这些就好实现了!!!

iOS WKWebView与JS交互

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,271评论 5 466
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,725评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,252评论 0 328
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,634评论 1 270
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,549评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,985评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,471评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,128评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,257评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,233评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,235评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,940评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,528评论 3 302
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,623评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,858评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,245评论 2 344
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,790评论 2 339

推荐阅读更多精彩内容