Language.Javascript.JSaddle

This package provides an EDSL for calling JavaScript code using the JavaScriptCore engine and low level Haskell bindings in the webkit-javascriptcore library https://github.com/ghcjs/webkit-javascriptcore.

JSaddle EDSL

The JSM monad gives us the context for evaluation. In keeping with JavaScript the EDSL has

• Weakish typing - type classes are used to convert to JSValueRef and Object types
• Strict evaluation - function in the JSM monad can be passed in place of a value and will evaluated and converted to JSValueRef or Object and then passed on to JavaScript

JSaddle should be used to write wrappers for JavaScript libraries that provide more type safety.

Code Examples

The code examples in this documentation are executed with a runjs function that executes the example code in the JSM monad and converts the result to Text with valToText. It also catches unhandled exceptions with catch. The source code can be found in tests/TestJSaddle.hs

Where it makes sense code examples are given in two forms. One that uses eval to run a purely JavaScript version and one that uses more of the JSaddle EDSL feature being demonstated.

Calling Haskell from JavaScript

You can call back into haskell from JavaScript using fun to convert a Haskell function in the JSM monad into a javascript value.

GHCJS Support

When built with ghcjs the code works using JavaScript FFI by default. It can also be built to use webkitgtk3-javascriptcore C FFI as there are shims for these (but this introduces a dependancy on WebKitGTK+ and is probably not as fast).

Modules