ceb03cfb03
Remove `ExtensionFileSourceCode::LoadedFromFsDuringSnapshot` and feature `include_js_for_snapshotting` since they leak paths that are only applicable in this repo to embedders. Replace with feature `exclude_js_sources`. Additionally the feature `force_include_js_sources` allows negating it, if both features are set. We need both of these because features are additive and there must be a way of force including sources for snapshot creation while still having the `exclude_js_sources` feature. `force_include_js_sources` is only set for build deps, so sources are still excluded from the final binary. You can also specify `force_include_js_sources` on any extension to override the above features for that extension. Towards #19398. But there was still the snapshot-from-snapshot situation where code could be executed twice, I addressed that by making `mod_evaluate()` and scripts like `core/01_core.js` behave idempotently. This allowed unifying `ext::init_ops()` and `ext::init_ops_and_esm()` into `ext::init()`. |
||
---|---|---|
.. | ||
examples | ||
00_primordials.js | ||
01_core.js | ||
02_error.js | ||
async_cancel.rs | ||
async_cell.rs | ||
bindings.js | ||
bindings.rs | ||
Cargo.toml | ||
encode_decode_test.js | ||
error.rs | ||
error_builder_test.js | ||
error_codes.rs | ||
extensions.rs | ||
fast_string.rs | ||
flags.rs | ||
gotham_state.rs | ||
icudtl.dat | ||
inspector.rs | ||
internal.d.ts | ||
io.rs | ||
lib.deno_core.d.ts | ||
lib.rs | ||
module_specifier.rs | ||
modules.rs | ||
normalize_path.rs | ||
ops.rs | ||
ops_builtin.rs | ||
ops_builtin_v8.rs | ||
ops_metrics.rs | ||
path.rs | ||
README.md | ||
realm.rs | ||
resources.rs | ||
runtime.rs | ||
serialize_deserialize_test.js | ||
snapshot_util.rs | ||
source_map.rs | ||
task.rs | ||
task_queue.rs |
Deno Core Crate
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).
Rust functions can be registered in JavaScript using deno_core::Extension
. Use
the Deno.core.ops.op_name()
and Deno.core.opAsync("op_name", ...)
functions
to trigger the op function callback. A conventional way to write ops is using
the deno_ops
crate.
Documentation for this crate is thin at the moment. Please see hello_world.rs and http_bench_json_ops/main.rs as examples of usage.
TypeScript support and lots of other functionality are not available at this layer. See the CLI for that.