1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-28 16:20:57 -05:00
denoland-deno/runtime
Bartek Iwańczuk f3c0f0565b
feat(core): Add ability to "ref" and "unref" pending ops (#12889)
This commit adds an ability to "ref" or "unref" pending ops.

Up to this point Deno had a notion of "async ops" and "unref async ops";
the former keep event loop alive, while the latter do not block event loop
from finishing. It was not possible to change between op types after
dispatching, one had to decide which type to use before dispatch.

Instead of storing ops in two separate "FuturesUnordered" collections,
now ops are stored in a single collection, with supplemental "HashSet"
storing ids of promises that were "unrefed".

Two APIs were added to "Deno.core":

"Deno.core.refOp(promiseId)" which allows to mark promise id
to be "refed" and keep event loop alive (the default behavior)
"Deno.core.unrefOp(promiseId)" which allows to mark promise
id as "unrefed" which won't block event loop from exiting
2021-11-25 19:49:09 +01:00
..
examples feat(runtime): allow passing extensions via Worker options (#12362) 2021-10-08 17:03:49 +02:00
js feat(core): Add ability to "ref" and "unref" pending ops (#12889) 2021-11-25 19:49:09 +01:00
ops feat(core): Add ability to "ref" and "unref" pending ops (#12889) 2021-11-25 19:49:09 +01:00
build.rs feat(ext/fetch): support fetching local files (#12545) 2021-11-01 15:29:46 +11:00
Cargo.toml chore: merge v1.16.3 into main (#12892) 2021-11-24 15:56:18 -08:00
colors.rs refactor: Remove duplicated colors.rs file (#11990) 2021-09-12 12:04:17 -04:00
errors.rs refactor(ext/http): rewrite hyper integration and fix bug (#12732) 2021-11-10 14:51:43 -08:00
fs_util.rs refactor: re-export anyhow from deno_core (#12777) 2021-11-16 09:02:28 -05:00
inspector_server.rs refactor: cleanup Inspector and InspectorServer implementations (#11837) 2021-08-25 13:39:23 +02:00
js.rs refactor: unify JavaScript script execution method (#11043) 2021-06-22 01:45:41 +02:00
lib.rs refactor(metrics): move to core (#12386) 2021-10-10 17:20:30 +02:00
permissions.rs chore: fix flaky permissions tests on windows (#12552) 2021-10-26 11:49:07 -04:00
README.md chore: fix decendents in runtime readme (#9718) 2021-03-08 13:23:46 +01:00
tokio_util.rs refactor: move mod tokio_util to runtime (#12332) 2021-11-08 12:49:11 -08:00
web_worker.rs refactor: move mod tokio_util to runtime (#12332) 2021-11-08 12:49:11 -08:00
worker.rs feat(ext/fetch): support fetching local files (#12545) 2021-11-01 15:29:46 +11:00
worker_bootstrap.rs refactor(runtime): Worker bootstrap options (#12299) 2021-10-05 22:41:14 +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.