deno/runtime
Bartek Iwańczuk b40086fd7d
refactor(core): include_js_files! 'dir' option doesn't change specifiers (#18019)
This commit changes "include_js_files!" macro from "deno_core"
in a way that "dir" option doesn't cause specifiers to be rewritten 
to include it.

Example:
```
include_js_files! {
  dir "js",
  "hello.js",
}
```

The above definition required embedders to use:
`import ... from "internal:<ext_name>/js/hello.js"`. 
But with this change, the "js" directory in which the files are stored
is an implementation detail, which for embedders results in: 
`import ... from "internal:<ext_name>/hello.js"`.

The directory the files are stored in, is an implementation detail and 
in some cases might result in a significant size difference for the 
snapshot. As an example, in "deno_node" extension, we store the 
source code in "polyfills" directory; which resulted in each specifier 
to look like "internal:deno_node/polyfills/<module_name>", but with 
this change it's "internal:deno_node/<module_name>". 

Given that "deno_node" has over 100 files, many of them having 
several import specifiers to the same extension, this change removes
10 characters from each import specifier.
2023-03-05 02:31:38 +00:00
..
examples refactor(permissions): add PermissionsContainer struct for internal mutability (#17134) 2023-01-07 17:25:34 +01:00
js refactor(core): include_js_files! 'dir' option doesn't change specifiers (#18019) 2023-03-05 02:31:38 +00:00
ops refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
permissions refactor(runtime): factor out FsPermissions for fs ops (#18012) 2023-03-05 00:44:59 +01:00
build.rs refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
Cargo.toml refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
colors.rs chore: use rustfmt imports_granularity option (#17421) 2023-01-14 23:18:58 -05:00
errors.rs fix: add WouldBlock error (#17339) 2023-02-12 23:14:33 +01:00
fmt_errors.rs refactor: rename deno specifiers to internal (#17655) 2023-02-05 17:49:20 +01:00
fs_util.rs chore: use rustfmt imports_granularity option (#17421) 2023-01-14 23:18:58 -05:00
inspector_server.rs chore: upgrade to Rust 1.67 (#17548) 2023-01-27 10:43:16 -05:00
js.rs build: add "include_js_files_for_snapshotting" Cargo feature (#17826) 2023-02-20 21:45:34 +01:00
lib.rs refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
README.md chore: fix decendents in runtime readme (#9718) 2021-03-08 13:23:46 +01:00
tokio_util.rs chore: update copyright year to 2023 (#17247) 2023-01-02 21:00:42 +00:00
web_worker.rs refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
worker.rs refactor(runtime): factor out deno_io extension crate (#18001) 2023-03-05 00:39:48 +00:00
worker_bootstrap.rs perf(core, runtime): Further improve startup time (#17860) 2023-02-22 06:25:31 +05:30

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 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.