JSCocoa, a bridge from Javascript to Cocoa

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.

Adding JSCocoa 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

• 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 alloc'd/retained will be dealloc'd/released when JSCocoaController's dealloccall JS GC.
  Broken — to cleanup, delete any js property then call JSGarbageCollect

Garbage Collection

	// Standard alloc
	var myObject = MyObjectClass.alloc.init
	// Use object
	...
	// Release
	myObject.release
	// Delete JS reference — object is now collectable
	myObject = null

	// Manually collect - object will be destroyed
	JSCocoaController.garbageCollect

	var object = MyObjectClass.instance
	// Use object
	...
	// Delete JS reference — object is now collectable
	object = null

	// Manually collect - object will be destroyed
	JSCocoaController.garbageCollect

Forgetting to set object = null will cause the object to live forever.

Call JSCocoaController.logInstanceStats to check on your objects' lifetime.