1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-29 16:30:56 -05:00
denoland-deno/core/README.md
2021-02-19 15:58:19 +01:00

1.5 KiB

Deno Core Crate

crates docs

The main dependency of this crate is rusty_v8, which provides the V8-Rust bindings.

This Rust crate contains the essential V8 bindings for Deno's command-line interface (Deno CLI). The main abstraction here is the JsRuntime which provides a way to execute JavaScript.

The JsRuntime implements an event loop abstraction for the executed code that keeps track of all pending tasks (async ops, dynamic module loads). It is user's responsibility to drive that loop by using JsRuntime::run_event_loop method - it must be executed in the context of Rust's future executor (eg. tokio, smol).

In order to bind Rust functions into JavaScript, use the Deno.core.dispatch() function to trigger the "dispatch" callback in Rust. The user is responsible for encoding both the request and response into a Uint8Array.

Documentation for this crate is thin at the moment. Please see http_bench_bin_ops.rs and http_bench_json_ops.rs as a simple example of usage.

TypeScript support and a lot of other functionality is not available at this layer. See the CLI for that.