Understanding JavaScriptCore in iOS: Architecture, Core Concepts, and Integration

JavaScriptCore (JSCore) is the JavaScript engine embedded in WebKit and used by iOS for executing JavaScript code. It acts as a bridge between Objective‑C (OC) and JavaScript, enabling hybrid app development.

The article introduces the background of dynamic rendering on mobile, mentions React Native, Weex, and explains that JSCore (referred to as JSCore) connects OC and JS.

From the Browser Perspective

JSCore originated from the JavaScript engine of Safari, later becoming a system‑level framework in iOS 7. It shares the same core as the WebKit engine used in browsers.

WebKit Overview

WebKit consists of modules such as WebCore and JSCore. The rendering pipeline includes loading resources, parsing HTML/CSS into DOM/CSSOM trees, merging them into a render tree, layout, and painting.

JSCore Components

JSCore is composed of a lexer, parser, LLInt interpreter and an optional JIT compiler. The lexer tokenises source code, the parser builds an abstract syntax tree (AST), and the interpreter executes bytecode. sum = 3 + 2; Example of lexical analysis result is shown in the article.

Feature Highlights

Register‑based instruction set (e.g., add i, a, b)

Single‑threaded execution model with an event‑driven loop (EventLoop) similar to iOS run‑loop.

Support for asynchronous tasks via WebWorker‑like mechanisms.

JSCore on iOS

iOS provides a JSCore framework that can be used from Swift, Objective‑C, or C. Developers can create a JSContext, evaluate scripts, and exchange values via JSValue.

JSContext *context = [[JSContext alloc] init];
[context evaluateScript:@"var a = 1; var b = 2;"];
NSInteger sum = [[context evaluateScript:@"a + b"] toInt32]; // sum = 3

Global objects can be injected, for example:

context[@"globalFunc"] = ^(){ NSArray *args = [JSContext currentArguments]; NSLog(@"Args: %@", args); };
context[@"globalProp"] = @"global string";
[context evaluateScript:@"globalFunc(globalProp)"];

JSExport protocol allows exposing native classes and methods to JavaScript.

@protocol PersonProtocol <JSExport>
- (NSString *)fullName;
@end

@interface JSExportPerson : NSObject <PersonProtocol>
@property (nonatomic, copy) NSString *firstName;
@property (nonatomic, copy) NSString *lastName;
- (NSString *)sayFullName;
@end

Instances of such classes can be assigned to a JSContext and called from JavaScript.

Garbage Collection

JSCore uses tracing garbage collection (GC) to manage memory automatically, unlike Objective‑C reference counting.

Summary

JSCore provides a lightweight, embeddable JavaScript engine for iOS apps. The key APIs are JSVirtualMachine, JSContext, and JSValue, which together enable bidirectional calls between native code and JavaScript, forming the basis of many hybrid solutions.