deno_rider

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #machine-learning #docker #awesome #cli #awesome-list #pytorch #security #openai #ios #open-source

(★ 79)

An embedded JavaScript runtime for Elixir.

deno_rider Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DenoRider

DenoRider is an Elixir library that embeds the [Deno](https://deno.com) runtime
via [Rustler](https://hexdocs.pm/rustler). It is a performant way to run
JavaScript in Elixir and it doesn't depend on external executables.

## Installation

Add `:deno_rider` to your `mix.exs`:

```elixir
{:deno_rider, "~> 0.2"}
```

Add `DenoRider` to your application's supervisor:

```elixir
# lib/my_app/application.ex
def start(_type, _args) do
  children = [
    ...,
    DenoRider
  ]

Supervisor.start_link(children, strategy: :one_for_one, name: MyApp.Supervisor)
end
```

See [`start_link/1`](https://hexdocs.pm/deno_rider/DenoRider.html#start_link/1)
for more information about options when starting DenoRider.

### Precompiled NIFs

DenoRider provides precompiled NIFs (via
[RustlerPrecompiled](https://hexdocs.pm/rustler_precompiled)) for the following
targets:

* `aarch64-apple-darwin`
* `aarch64-unknown-linux-gnu`
* `x86_64-apple-darwin`
* `x86_64-pc-windows-msvc`
* `x86_64-unknown-linux-gnu`

Contributions for precompiling DenoRider to more targets are welcome!

You can build DenoRider yourself by setting the environment variable
`DENO_RIDER_BUILD` to `true`.

## Usage

To run JavaScript code with DenoRider, you use `eval`. For example:

```elixir
iex> DenoRider.eval("1 + 2")
{:ok, 3}
iex> DenoRider.eval("globalThis.foo = 'bar'")
{:ok, "bar"}
iex> DenoRider.eval("globalThis.foo")
{:ok, "bar"}
```

See [`eval/1`](https://hexdocs.pm/deno_rider/DenoRider.html#eval/1) and
[`eval/2`](https://hexdocs.pm/deno_rider/DenoRider.html#eval/2) for different
ways of running JavaScript code.

If you don't want to run DenoRider as a linked process, you can manage the
process manually:

```elixir
iex> {:ok, pid} = DenoRider.start()
{:ok, #PID<0.192.0>}
iex> DenoRider.eval("1 + 2", pid: pid)
{:ok, 3}
iex> DenoRider.stop(pid: pid)
:ok
```

Read the [full documentation](https://hexdocs.pm/deno_rider/DenoRider.html) for
more information.

### JavaScript API

Inside the JavaScript runtime, DenoRider provides a JavaScript API under the
global object `DenoRider`. Currently, `DenoRider.apply` is the only available
function.

#### `DenoRider.apply`

Call an Elixir or Erlang function from JavaScript. Similarly to
[`Kernel.apply/3`](https://hexdocs.pm/elixir/Kernel.html#apply/3), it takes a
module, a function and an array of arguments:

```javascript
await DenoRider.apply("Kernel", "+", [1, 2]); // 3
await DenoRider.apply(":math", "floor", [3.14]); // 3
```

It returns a promise that resolves with the value returned from the Elixir
function. Note that the return value needs to be JSON encodable.

## FAQ

### When should I use DenoRider?

If you need to run JavaScript from Elixir, you can give DenoRider a try. Some
common use cases for that is for example server-side rendering of React or
wrapping a JavaScript library in Elixir.

### What makes DenoRider different from other ways of calling JavaScript from Elixir?

Since DenoRider embeds the Deno runtime, you don't need any external executables
(such as `node`) and the latency for your JavaScript calls is very low.

### When shouldn't I use DenoRider?

One reason could be that you want to use another JavaScript runtime, such as
Node or Bun. Or if you want to use Deno features that DenoRider doesn't provide.

### What are some common pitfalls?

There's currently no npm integration, which means that if you want to use an npm
package you first need to convert it into something that's consumable by
DenoRider. To do that you can use [Rollup](https://rollupjs.org), for example.

## License

DenoRider is released under the MIT license. See the [LICENSE](LICENSE) file for
more information.

deno_rider

deno_rider Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

deno_rider

deno_rider Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README