JSCocoa, a bridge from Javascript to Cocoa

Written by Patrick Geiller — parmanoir@gmail.com — Google Home — Wanna contribute ? Send me a mail !

QuickStart

JSCocoa.app interactive console that can execute Javascript commands. You can call anything here, provided it fits on one line. Click the help button to execute sample commands.
JSCoreAnimation.app Core Animation process viewer written in Javascript.

What's in here

JSCocoa JSCocoa files
JSCocoaGUIConsole interactive console that can execute Javascript commands. You can call anything here, provided it fits on one line. Click the help button to execute sample commands
JSCocoaConsole REPL console written by Tom Robinson
JSProcessViewer Core Animation process viewer, written in JSCocoa
iPhoneTest2 sample iPhone code running in iPhone simulator

JSCocoa in the wild

Kumagai Kentaro's iPhone console run Javascript commands on the iPhone simulator
Gus Mueller's Coda plugin run Javascript commands in Coda
Tom Robinson's JSCocoa REPL console a Read-Eval-Print-Loop console to run in Terminal

Adding JSCocoa to your project

After building JSCocoa/JSCocoa.xcodeproj, drag /Library/Frameworks/JSCocoa.framework into your project and import it with #import <JSCocoa/JSCocoa.h>.

Adding JSCocoa to your project (non framework version)

If you don't want to use JSCocoa as a framework, you can manually add it to your project :

Copy (or reference) all the files from the JSCocoa folder in your project.
Add JavascriptCore.framework to frameworks
In 'Build' project settings, add -lffi to 'Other linker flags'

Starting JSCocoa

Starting JSCocoa depends on the lifetime you want for your JS objects.

program lifetime start JSCocoa in main.c

	[[NSAutoreleasePool alloc] init];
	id JSCocoa = [JSCocoaController sharedController];
	[JSCocoa evalJSFile:@"myFile.js"];
	// Standard ObjC alloc
	return NSApplicationMain(argc,  (const char **) argv);

use and discard lifetime for things like executing a script after
- manually create a controller with [[JSCocoaController alloc] init]
- Call evalJSFile or evalJSString
- Destroy the allocated controller. Any object you allocated/retained will be deallocated/released when JSCocoaController's dealloc calls JS GC.

Garbage Collection

How Javascript Garbage Collection works with ObjC objects