deno/core
Andreu Botella 4d6f412b0b
refactor(core): Turn the wasm_streaming_feed binding into ops (#11985)
Async WebAssembly compilation was implemented by adding two
bindings: `set_wasm_streaming_callback`, which registered a callback to
be called whenever a streaming wasm compilation was started, and
`wasm_streaming_feed`, which let the JS callback modify the state of the
v8 wasm compiler.

`set_wasm_streaming_callback` cannot currently be implemented as
anything other than a binding, but `wasm_streaming_feed` does not really
need to use anything specific to bindings, and could indeed be
implemented as one or more ops. This PR does that, resulting in a
simplification of the relevant code.

There are three operations on the state of the v8 wasm compiler that
`wasm_streaming_feed` allowed: feeding new bytes into the compiler,
letting it know that there are no more bytes coming from the network,
and aborting the compilation. This PR provides `op_wasm_streaming_feed`
to feed new bytes into the compiler, and `op_wasm_streaming_abort` to
abort the compilation. It doesn't provide an op to let v8 know that the
response is finished, but closing the resource with `Deno.core.close()`
will achieve that.
2021-09-13 14:27:54 +02:00
..
examples feat(core): facilitate op-disabling middleware (#11858) 2021-08-31 13:08:16 +02:00
00_primordials.js feat(fmt): add basic JS doc formatting (#11902) 2021-09-02 18:28:12 -04:00
01_core.js perf(ext/http): optimize auto cleanup of request resource (#11978) 2021-09-10 15:47:09 -07:00
02_error.js refactor: introduce primordials (#10939) 2021-07-02 12:18:30 +02:00
async_cancel.rs chore: upgrade Rust to 1.53.0 (#11021) 2021-06-17 15:56:30 -04:00
async_cell.rs
bindings.rs refactor(core): Turn the wasm_streaming_feed binding into ops (#11985) 2021-09-13 14:27:54 +02:00
Cargo.toml chore: update dependencies (#11856) 2021-09-02 23:38:44 +02:00
encode_decode_test.js
error.rs fix(ext/web): Format terminal DOMExceptions properly (#11834) 2021-09-06 22:59:20 +02:00
error_builder_test.js refactor: use primordials in runtime, extensions and core (#11500) 2021-07-26 13:52:59 +02:00
extensions.rs core: don't include_str extension js code (#10786) 2021-05-29 16:20:52 +02:00
flags.rs
gotham_state.rs fix(core): better "missing type" GothamState error (#10189) 2021-04-14 23:11:39 +02:00
icudtl.dat upgrade: rusty_v8 0.23.0 (V8 9.2.230.12) (#11113) 2021-06-25 12:54:53 +02:00
inspector.rs fix(doc): fix rustdoc bare_urls warning (#11921) 2021-09-05 16:22:45 +02:00
internal.d.ts chore: upgrade Rust to 1.54.0 (#11554) 2021-07-30 15:03:41 +02:00
lib.deno_core.d.ts refactor(core): Turn the wasm_streaming_feed binding into ops (#11985) 2021-09-13 14:27:54 +02:00
lib.rs fix(doc): fix rustdoc bare_urls warning (#11921) 2021-09-05 16:22:45 +02:00
module_specifier.rs fix(doc): fix rustdoc bare_urls warning (#11921) 2021-09-05 16:22:45 +02:00
modules.rs fix(doc): fix rustdoc bare_urls warning (#11921) 2021-09-05 16:22:45 +02:00
normalize_path.rs fix(doc): fix rustdoc bare_urls warning (#11921) 2021-09-05 16:22:45 +02:00
ops.rs refactor(ops): replace ZeroCopyBuf arg by 2nd generic deserializable arg (#10448) 2021-05-06 19:32:03 +02:00
ops_builtin.rs refactor(core): Turn the wasm_streaming_feed binding into ops (#11985) 2021-09-13 14:27:54 +02:00
ops_json.rs feat(core): facilitate op-disabling middleware (#11858) 2021-08-31 13:08:16 +02:00
README.md docs(core): replaces dispatch references with op (#11054) 2021-06-20 17:12:55 +02:00
resources.rs refactor(ops): return BadResource errors in ResourceTable calls (#11710) 2021-08-15 13:29:19 +02:00
runtime.rs feat(cli): close test worker once all tests complete (#11727) 2021-09-04 20:19:26 +02:00
serialize_deserialize_test.js feat(extensions/web): add structuredClone function (#11572) 2021-08-09 10:39:00 +02:00

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.opSync() and Deno.core.opAsync() functions to trigger the "op_fn" callback in JsRuntime::register_op on Rust side. A conventional way to handle "op_fn" callbacks is to use the op_sync and op_async functions.

Documentation for this crate is thin at the moment. Please see hello_world.rs and http_bench_json_ops.rs as examples of usage.

TypeScript support and lots of other functionality are not available at this layer. See the CLI for that.