An open API service indexing awesome lists of open source software.

https://github.com/ad-si/mquickjs-hs

Haskell wrapper for the Micro QuickJS JavaScript Engine
https://github.com/ad-si/mquickjs-hs

es5 haskell javascript library mquickjs quickjs wrapper

Last synced: 6 days ago
JSON representation

Haskell wrapper for the Micro QuickJS JavaScript Engine

Awesome Lists containing this project

README

          

# mquickjs-hs

This package provides a Haskell wrapper for the [Micro QuickJS](https://github.com/bellard/mquickjs) JavaScript Engine.
It has been inspired by the [quickjs-rs](https://github.com/theduke/quickjs-rs)
and [ocaml-quickjs](https://github.com/dhcmrlchtdj/ocaml-quickjs) libraries.

## Features

The functionality is quite basic and is currently limited to:
- Evaluating JS code
- Calling a JS function in the global scope
- Marshalling [Aeson Values](https://hackage.haskell.org/package/aeson-1.5.3.0/docs/Data-Aeson.html#t:Value)
to and from JSValues.

## Examples

Evaluate an expression:

```hs
import MQuickJS

one_plus_two = mquickjs $ do
res <- eval "1+2"
liftIO $ print res
```

Declare a function and call it on an argument:

```hs
call_f = mquickjs $ do
_ <- eval_ "function f(x) { return x + 1; }"
res <- eval "f(2)"
liftIO $ print res
```

Pass a Haskell value
(which has a [ToJSON](https://hackage.haskell.org/package/aeson-1.5.3.0/docs/Data-Aeson.html#t:ToJSON) instance)
to the JS runtime:

```hs
aeson_marshall = mquickjs $ do
_ <- eval_ "function f(x) { return x + 1; }"
res <- withJSValue (3::Int) $ \x -> call "f" [x]
liftIO $ print res
```

## Contributing

Please feel free to report bugs/submit feature requests via the
[github issue tracker](https://github.com/ad-si/mquickjs-hs/issues)
and submit any pull requests to the
[git repository](https://github.com/ad-si/mquickjs-hs/).