Skip to content

docs: document additional Windows signals#3094

Merged
bartlomieju merged 4 commits into
denoland:2.8from
lunadogbot:docs/2.8-windows-signals
May 20, 2026
Merged

docs: document additional Windows signals#3094
bartlomieju merged 4 commits into
denoland:2.8from
lunadogbot:docs/2.8-windows-signals

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

Documents the Windows signal-set expansion in Deno 2.8 (denoland/deno#32689).

  • Updates the leading admonition in examples/tutorials/os_signals.md — Windows now also supports SIGTERM and SIGQUIT for addSignalListener.
  • Adds a new "Windows support" section with two tables:
    • Deno.addSignalListenerSIGINT, SIGBREAK, SIGTERM, SIGQUIT.
    • Deno.kill — additionally accepts SIGKILL, SIGABRT, and signal 0 for health checks (all map to TerminateProcess).
  • Notes that SIGKILL / SIGABRT are deliberately not registerable as listeners (matches Unix).

Test plan

  • deno task serve — tutorial renders, the new section's table aligns.

The OS signals tutorial previously only mentioned SIGINT and SIGBREAK
on Windows. Updates the leading note and adds a new "Windows support"
section listing the full sets supported by addSignalListener and
Deno.kill as of Deno 2.8 (SIGTERM, SIGQUIT, SIGKILL, SIGABRT, signal
0). Notes that SIGKILL / SIGABRT cannot be registered as listeners.

Refs denoland/deno#32689
SIGTERM/SIGQUIT support on Windows shipped in 2.7.6 (deno#32689), not 2.8.
@lunadogbot lunadogbot changed the title docs: document additional Windows signals (2.8) docs: document additional Windows signals May 2, 2026
@crowlKats crowlKats changed the base branch from main to 2.8 May 5, 2026 11:42
Copy link
Copy Markdown
Contributor

@fibibot fibibot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Deno.addSignalListener(sig, …) omits SIGHUP and SIGWINCH from the Windows listener set. Current denoland/deno cli/tsc/dts/lib.deno.ns.d.ts documents Windows support for SIGINT, SIGBREAK, SIGTERM, SIGQUIT, SIGHUP, and SIGWINCH, and ext/signals/dict.rs maps those signals on Windows; please include both in the warning/table so this page does not under-document supported listeners.
  2. last_modified: 2025-03-10 is unchanged for this content update. Please bump the frontmatter date for the page update.

@bartlomieju bartlomieju merged commit 901978f into denoland:2.8 May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants