JavaScriptCore你不知道的事

其实很长时间就想写一遍关于 JavaScriptCore文章，一是为了记录下自己的学习过程，二是讲下自己对学习JavaScriptCore的一些见解。

JavaScriptCore是在iOS7上才被Apple开放到ios application中的，让我们native的开发者有些事情可以做了。言归正传，让我们先从文档的 JavaScriptCore.h 头文件开始！

================
简单概述
================
// JavaScript运行环境的上下文
#import "JSContext.h" 

// 用于JavaScript类型和Objective-C类型的转换封装，JavaScript执行结果
#import "JSValue.h" 

// 处理JavaScript和Objective-C语言环境循环引用的问题
#import "JSManagedValue.h" 

// JavaScript执行环境的虚拟机，一个虚拟机代表一个线程的JavaScript运行环境
#import "JSVirtualMachine.h" 

// 是一个协议，只有遵守JSExport协议的Objective-C对象，才能被JavaScript调用
#import "JSExport.h"

JSContext要点

每一个JSContext初始化都带一个JSVirtualMachine,而 - (instancetype)init 时是系统提供了默认的JSVirtualMachine。
使用 - (JSValue *)evaluateScript:withSourceURL:(NSURL *)sourceURL; sourceURL可以写一些debug代码在文件中，以方便调试代码用。
globalObject相当于浏览器中的window对象，实际上JavaScript代码都是在这个GlobalObject上执行的。
void(^exceptionHandler)(JSContext *context, JSValue *exception);可以重写实现，打印出我们要的exception信息，但别忘了把exception塞回给context. exception
支持下标语法（SubscriptSupport）

JSValue要点

每一个JSValue初始化都需要上下文创建！
JavaScript类型和Objective-C类型之间对应关系

Objective-C type | JavaScript type
--------------+----------------
nil | undefined
NSNull | null
NSString | string
NSNumber | number, boolean
NSDictionary | Object object
NSArray | Array object
NSDate | Date object
NSBlock | Function object
id | Wrapper object
Class | Constructor object
callWithArguments: 该方法用于 JSValue为 Function object时！
constructWithArguments:(NSArray *)arguments 调用JavaScript中的构造函数，arguments数组内容必须是JSValue对象，以供JavaScript能顺利转化
JSValue也支持下标语法
支持结构体类型转换如：CGPoint,CGRect,CGSize,NSRange

向context中赋值block时要点（由于Objective-C block值捕获的特性）

在向context中赋值block时，block不能直接访问外部变量和代码，应该通过参数传入。
block中利用JSContext提供的类方法，currentContext 、currentCallee、currentArguments 访问 content中的内容

JSManagedValue要点

该对象是用来解决JavaScrite语言环境和Objective-C语言环境不同而导致循环引用问题的。防止双方因内存释放问题而导致crash。

初始化方法主要参数是 JSValue，相当于是对JSValue的包装，用于解决循环引用的问题。
JSManagedValue不是继承至JSValue

JSVirtualMachine要点

可以理解为一个JSVirtualMachine 虚拟机就是一个单独JavaScrite运行环境，并且是线程安全的。前面提到了JSContent的初始化一定有一个对应的JSVirtualMachine运行环境，并且一个JSVirtualMachine可以创建多个JSContent,而且在层面是不同的JSContent是可以相互通信的。

不同JSVirtualMachine虚拟机环境将在不同的线程中，那也就是说我们实现类似Web worker的异步功能，但我们也别忘了线程之间的安全问题和线程之前的通信，也避免不了代码中使用很多的block回调。

JSExport要点

是一个协议，不是一个对象
平时编码的时候一般是自定义一个协议继承至JSExport，协议中可以声明属性、实例方法、类方法和初始化方法,使用时只要我们的Objective-C对象实现协议中声明的内容，将可以在被JavaScripte进行转换，反之，没有在JSExport中声明的将不能在JavaScript中访问。

其实JSExport已经支持初始化方式的桥接 Google很多文章说 JSExport doesn't support constructors ,但在我的电脑环境为Xcode 8.3.1 IOS 10.3运行了下面的代码

  @protocol TestInterface <JSExport>
  -(instancetype)initWithString:(NSString *)string;
  @property (readonly) NSString *string;
  @end
  
  @interface TestClass : NSObject <TestInterface>
  @end
  
  @implementation TestClass
  @synthesize string = _string;
  - (instancetype)initWithString:(NSString *)string
  {
       if (!(self = [super init])) return nil;
      _string = [string copy];
      return self;
  }
  @end
  
  - (void)viewDidLoad {
      [super viewDidLoad];
      
      JSContext *context = [[JSContext alloc] init];
      context[@"TestClass"] = [TestClass class];

      JSValue *result0 = [context evaluateScript:@"(new TestClass())"];
      JSValue *result1 = [context evaluateScript:@"(new TestClass(\"Hello, world!\")).string"];
      JSValue *result2 = [context evaluateScript:@"(typeof TestClass.prototype.constructor)"];
      JSValue *result3 = [context evaluateScript:@"(new TestClass.prototype.constructor)"];

      NSLog(@"\n result0 : %@,\n result1:%@, \n result2:%@,  \n result3 = %@, \n class = %@",result0,result1,result2,result3,context[@"TestClass"]);
  }

  打印结果为：
  result0 : <TestClass: 0x608000013570>,
  result1:Hello, world!, 
  result2:function,  
  result3 = <TestClass: 0x608000013590>, 
  class = TestClass

constructor 可以调用JSExport中声明的类方法

  ===========
  swift代码
  ===========
  @objc protocol MovieJSExports: JSExport {
      var title: String { get set }
      var price: String { get set }
      var imageUrl: String { get set }
      // 声明的类方法
      static func movieWith(title: String, price: String, imageUrl: String) -> Movie
  }
  
  class Movie: NSObject, MovieJSExports {
      dynamic var title: String
      dynamic var price: String
      dynamic var imageUrl: String

      init(title: String, price: String, imageUrl: String) {
          self.title = title
          self.price = price
          self.imageUrl = imageUrl
      }
      
      // 类方法的实现，且通过传入的参数，初始化一个Movie对象
      class func movieWith(title: String, price: String, imageUrl: String) -> Movie {
          return Movie(title: title, price: price, imageUrl: imageUrl)
      }
  }
  
  ==============
  JavaScript代码
  ==============
  var mapToNative = function(movies) {
      return movies.map(function (movie) {
          // constructor 调用Movie实现的类方法，返回Movie对象，这个map用的精髓
          return Movie.movieWithTitlePriceImageUrl(movie.title, movie.price, movie.imageUrl);
      });
  };

以上代码出自：
JavaScriptCore Tutorial for iOS: Getting Started

JavaScript和Objective-C之间的相互调用

Objective-C调用JavaScript

  ===============
  通过JSContent
  ===============
  - (JSValue *)evaluateScript:(NSString *)script;
  - (JSValue *)evaluateScript:(NSString *)script withSourceURL:(NSURL *)sourceURL NS_AVAILABLE(10_10, 8_0);
  
  ===============
  通过JSValue 
  ===============
  // 适用于JSValue 为 Functions
  - (JSValue *)callWithArguments:(NSArray *)arguments;
  // 适用于JSValue 为一个constructor    可以通过@"Class.prototype.constructor" 获得，上面有类是的代码
  - (JSValue *)constructWithArguments:(NSArray *)arguments;
  // 适用于JSValue中的声明的方法
  - (JSValue *)invokeMethod:(NSString *)method withArguments:(NSArray *)arguments;

JavaScript调用Objective-C

一种方式是通过 block 的方式，把一个block塞入JSContent中，然后JavaScript就能调用对应的function了

第二种方式是通过 JSExport中的声明，通过Objective-C实现，而JavaScript负责调用

Objective-C捕获JavaScript中的exception

通过exceptionHandler这个block 
context.exceptionHandler = ^(JSContext *context, JSValue *exception) {
    context.exception = exception;
    NSLog(@"exception");
};

补充

平时开发中可以把JavaScript代码写入对应的.js文件中，便于管理和执行JavaScript时通过文件的方式生成JavaScript代码
Objective-C也可以实现 JavaScript中的console,基本原理就是利用 + (NSArray *)currentArguments;方法
JSExportAs(PropertyName, Selector) 使用可以对比较长的Methods取一个适合JavaScript调用的名字

最后

写到这里的时候，才感觉到该文章偏理论了，后续如果有时间将提供一些相关代码。希望这边文章能对你理解JavaScriptCore有帮助，以上内容有什么问题可以提出，我将及时改正！一起学习、一起成长！