deno/runtime
Mathias Lafeldt ee122c5af6
feat(runtime): allow adding custom extensions to snapshot (#23569)
This makes `create_runtime_snapshot` more useful for embedders who add
their own extension(s) to the runtime in build scripts.

---------

Signed-off-by: Matt Mastracci <matthew@mastracci.com>
Co-authored-by: Matt Mastracci <matthew@mastracci.com>
2024-05-01 22:00:32 +00:00
..
examples/extension fix(cli): unbreak extension example and fix __runtime_js_sources (#22906) 2024-03-14 04:23:37 +01:00
js feat: Add deno serve subcommand (#23511) 2024-04-24 19:45:49 +00:00
ops chore: upgrade deno_core to 0.274.0 (#23344) 2024-04-12 21:45:38 +02:00
permissions 1.43.0 (#23629) 2024-05-01 12:16:39 +05:30
Cargo.toml 1.43.0 (#23629) 2024-05-01 12:16:39 +05:30
clippy.toml feat(compile): unstable npm and node specifier support (#19005) 2023-05-10 20:06:59 -04:00
code_cache.rs perf: v8 code cache (#23081) 2024-04-17 07:19:55 -07:00
errors.rs chore: update copyright to 2024 (#21753) 2024-01-01 19:58:21 +00:00
fmt_errors.rs refactor: extract out runtime::colors to deno_terminal::colors (#22324) 2024-02-07 11:25:14 -05:00
fs_util.rs perf: v8 code cache (#23081) 2024-04-17 07:19:55 -07:00
inspector_server.rs fix(inspector): don't panic if port is not free (#22745) 2024-04-12 01:17:10 +02:00
js.rs refactor: remove snapshotting from deno_runtime (#21794) 2024-01-10 16:30:50 +01:00
lib.rs feat: Add deno serve subcommand (#23511) 2024-04-24 19:45:49 +00:00
permissions.rs feat(runtime): Allow embedders to perform additional access checks on file open (#23208) 2024-04-19 18:12:03 -06:00
README.md fix (doc): Typo in runtime/README.md (#20020) 2023-12-13 17:24:32 +00:00
shared.rs chore: remove unused, unstable 'http' namespace (#23436) 2024-04-18 11:21:25 -06:00
snapshot.rs feat(runtime): allow adding custom extensions to snapshot (#23569) 2024-05-01 22:00:32 +00:00
tokio_util.rs fix: unref stdin read (#23534) 2024-04-25 05:32:01 +00:00
web_worker.rs fix(ext/node): support MessagePort in WorkerOptions.workerData (#22950) 2024-03-16 01:59:18 +01:00
worker.rs perf: v8 code cache (#23081) 2024-04-17 07:19:55 -07:00
worker_bootstrap.rs feat: Add deno serve subcommand (#23511) 2024-04-24 19:45:49 +00:00

deno_runtime crate

crates docs

This is a slim version of the Deno CLI which removes typescript integration and various tooling (like lint and doc). Basically only JavaScript execution with Deno's operating system bindings (ops).

Stability

This crate is built using battle-tested modules that were originally in the deno crate, however the API of this crate is subject to rapid and breaking changes.

MainWorker

The main API of this crate is MainWorker. MainWorker is a structure encapsulating deno_core::JsRuntime with a set of ops used to implement Deno namespace.

When creating a MainWorker implementors must call MainWorker::bootstrap to prepare JS runtime for use.

MainWorker is highly configurable and allows to customize many of the runtime's properties:

  • module loading implementation
  • error formatting
  • support for source maps
  • support for V8 inspector and Chrome Devtools debugger
  • HTTP client user agent, CA certificate
  • random number generator seed

Worker Web API

deno_runtime comes with support for Worker Web API. The Worker API is implemented using WebWorker structure.

When creating a new instance of MainWorker implementors must provide a callback function that is used when creating a new instance of Worker.

All WebWorker instances are descendents of MainWorker which is responsible for setting up communication with child worker. Each WebWorker spawns a new OS thread that is dedicated solely to that worker.