1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-25 15:29:32 -05:00
denoland-deno/runtime
Nayeem Rahman 45c49034a7
BREAKING(unstable): Improve Deno.spawn() stdio API (#14919)
- "SpawnOutput" extends "ChildStatus" instead of composing it
- "SpawnOutput::stdout", "SpawnOutput::stderr", "Child::stdin", 
"Child::stdout" and "Child::stderr" are no longer optional, instead 
made them getters that throw at runtime if that stream wasn't set 
to "piped". 
- Remove the complicated "<T extends SpawnOptions = SpawnOptions>" 
which we currently need to give proper type hints for the availability of 
these fields. Their typings for these would get increasingly complex 
if it became dependent on more options (e.g. "SpawnOptions::pty" 
which if set should make the stdio streams unavailable)
2022-07-18 15:16:12 +02:00
..
examples Revert "refactor(snapshots): to their own crate (#14794)" (#15076) 2022-07-05 00:12:41 +02:00
js BREAKING(unstable): Improve Deno.spawn() stdio API (#14919) 2022-07-18 15:16:12 +02:00
ops chore: fix Windows specific clippy errors (#15212) 2022-07-15 12:30:25 -04:00
build.rs Revert "refactor(snapshots): to their own crate (#14794)" (#15076) 2022-07-05 00:12:41 +02:00
Cargo.toml chore: forward v1.23.4 release commit to main (#15172) 2022-07-12 17:08:36 -04:00
colors.rs feat(test): change "failures:" headers in test report (#14490) 2022-05-09 10:56:13 +02:00
errors.rs chore: update copyright to 2022 (#13306) 2022-01-07 22:09:52 -05:00
fs_util.rs chore: update copyright to 2022 (#13306) 2022-01-07 22:09:52 -05:00
inspector_server.rs chore: upgrade to rust 1.58 (#13377) 2022-01-15 07:10:12 +01:00
js.rs Revert "refactor(snapshots): to their own crate (#14794)" (#15076) 2022-07-05 00:12:41 +02:00
lib.rs chore(ext/timers): move ext/timers to ext/web (#13665) 2022-02-15 12:17:30 +01:00
permissions.rs chore: fix Windows specific clippy errors (#15212) 2022-07-15 12:30:25 -04:00
README.md chore: fix decendents in runtime readme (#9718) 2021-03-08 13:23:46 +01:00
tokio_util.rs refactor: rename run_basic to run_local (#15068) 2022-07-11 19:02:23 +02:00
web_worker.rs refactor: rename run_basic to run_local (#15068) 2022-07-11 19:02:23 +02:00
worker.rs Revert "refactor(snapshots): to their own crate (#14794)" (#15076) 2022-07-05 00:12:41 +02:00
worker_bootstrap.rs feat: add userAgent property to Navigator's prototype (#14415) 2022-05-14 12:00:02 +02: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 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.