deno/runtime
Bartek Iwańczuk 2d9a844555
feat(runtime): add SIGUSR2 handler for low memory notifications (#29295)
This commit adds a signal handler for SIGUSR2 that helps reduce the
memory usage of both main worker and web worker by:

1. Triggering `malloc_trim(0)` to release memory back to the system
2. Invoking V8 isolate's `low_memory_notification` function

This is only available on Linux and enabled when `DENO_USR2_MEMORY_TRIM`
env var is specified.

---------

Co-authored-by: Yusuke Tanaka <yusuktan@maguro.dev>
2025-05-16 14:59:47 +02:00
..
examples/extension feat: deno_core 0.344.0 (#29089) 2025-04-29 13:15:08 +02:00
features 2.3.2 (#29320) 2025-05-16 01:18:59 +02:00
js fix: allow specifying otel config in --env-file (#29240) 2025-05-11 21:09:52 -04:00
ops fix(otel): don't panic when using worker threads (#29248) 2025-05-12 02:51:08 +02:00
permissions 2.3.2 (#29320) 2025-05-16 01:18:59 +02:00
Cargo.toml 2.3.2 (#29320) 2025-05-16 01:18:59 +02:00
clippy.toml fix: otel resiliency (#26857) 2024-11-14 12:16:28 +00:00
code_cache.rs chore: Happy New Year 2025 (#27509) 2024-12-31 19:12:39 +00:00
fmt_errors.rs fix(run): skip the cjs suggestion for mjs/mts modules (#26698) 2025-03-05 17:29:41 +00:00
fs_util.rs refactor: update deno_core and use more concrete errors (#27620) 2025-01-17 09:41:52 -08:00
inspector_server.rs refactor: reduce dependency on futures crate (#28515) 2025-03-17 14:14:19 +00:00
js.rs chore: Happy New Year 2025 (#27509) 2024-12-31 19:12:39 +00:00
lib.rs fix: allow specifying otel config in --env-file (#29240) 2025-05-11 21:09:52 -04:00
permissions.rs chore: Happy New Year 2025 (#27509) 2024-12-31 19:12:39 +00:00
README.md fix (doc): Typo in runtime/README.md (#20020) 2023-12-13 17:24:32 +00:00
shared.rs feat: Codegen feature flags (#28920) 2025-04-25 08:33:45 +00:00
snapshot.rs refactor: allow lazy main module (#28929) 2025-04-30 19:59:20 +00:00
snapshot_info.rs feat(ext/fetch): add support for fetch on unix sockets (#29154) 2025-05-13 18:06:17 +02:00
tokio_util.rs chore: Happy New Year 2025 (#27509) 2024-12-31 19:12:39 +00:00
transpile.rs chore: fix hmr build (#27781) 2025-01-22 18:00:36 +00:00
web_worker.rs feat(runtime): add SIGUSR2 handler for low memory notifications (#29295) 2025-05-16 14:59:47 +02:00
worker.rs feat(runtime): add SIGUSR2 handler for low memory notifications (#29295) 2025-05-16 14:59:47 +02:00
worker_bootstrap.rs fix: allow specifying otel config in --env-file (#29240) 2025-05-11 21:09:52 -04: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.