1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-26 09:10:40 -05:00
denoland-deno/runtime
Luca Casonato f3bde1d53b
feat(ext/flash): split upgradeHttp into two APIs (#15557)
This commit splits `Deno.upgradeHttp` into two different APIs, because
the same API is currently overloaded with two different functions. Flash
requests upgrade immediately, with no need to return a `Response`
object. Instead you have to manually write the response to the socket.
Hyper requests only upgrade once a `Response` object has been sent.

These two behaviours are now split into `Deno.upgradeHttp` and
`Deno.upgradeHttpRaw`. The latter is flash only. The former only
supports hyper requests at the moment, but can be updated to support
flash in the future.

Additionally this removes `void | Promise<void>` as valid return types
for the handler function. If one wants to use `Deno.upgradeHttpRaw`,
they will have to type cast the handler signature - the signature is
meant for the 99.99%, and should not be complicated for the 0.01% that
use `Deno.upgradeHttpRaw()`.
2022-08-24 17:40:57 +05:30
..
examples feat(unstable): initial support for npm specifiers (#15484) 2022-08-20 11:31:33 -04:00
js feat(ext/flash): split upgradeHttp into two APIs (#15557) 2022-08-24 17:40:57 +05:30
ops perf(runtime): optimize Deno.file open & stream (#15496) 2022-08-19 15:54:40 +05:30
build.rs feat(unstable): initial support for npm specifiers (#15484) 2022-08-20 11:31:33 -04:00
Cargo.toml feat(ext/flash): An optimized http/1.1 server (#15405) 2022-08-18 17:35:02 +05:30
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 feat: add ext/node for require support (#15362) 2022-08-09 21:06:01 +02:00
permissions.rs feat(ext/flash): An optimized http/1.1 server (#15405) 2022-08-18 17:35:02 +05:30
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 feat(unstable): initial support for npm specifiers (#15484) 2022-08-20 11:31:33 -04:00
worker.rs feat(unstable): initial support for npm specifiers (#15484) 2022-08-20 11:31:33 -04: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.