mirror of
https://github.com/denoland/deno.git
synced 2024-12-28 10:09:20 -05:00
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# Deno Core Crate
|
|
|
|
[![crates](https://img.shields.io/crates/v/deno_core.svg)](https://crates.io/crates/deno_core)
|
|
[![docs](https://docs.rs/deno_core/badge.svg)](https://docs.rs/deno_core)
|
|
|
|
The main dependency of this crate is
|
|
[rusty_v8](https://github.com/denoland/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](https://github.com/denoland/deno/blob/master/core/examples/http_bench_bin_ops.rs)
|
|
and
|
|
[http_bench_json_ops.rs](https://github.com/denoland/deno/blob/master/core/examples/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](https://github.com/denoland/deno/tree/master/cli) for that.
|