nodejs / nodejs/node

Add passive signal observers

Offen
#62,909 2 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

feature request
Vorherrschende Sprache
JavaScript
Sterne
122k
Forks
37.3k
Ø Merge
4 T. 2 Std.
Gemergte PRs (30 T.)
283

Beschreibung

What is the problem this feature will solve?

Node currently exposes signals through process.on('SIGINT') / process.on('SIGTERM'), but that API combines two very different needs:

  • observing that a signal happened
  • taking ownership of shutdown behavior

That coupling creates avoidable ecosystem friction. Many libraries only need best-effort cleanup when a process is interrupted, for example restoring terminal state, showing the cursor again, or stopping a spinner. Today, the only way to do that is to install a real signal handler, which changes global process semantics, suppresses default behavior, and can interfere with app-defined handlers.

What is the feature you are proposing to solve the problem?

Node should add a passive API such as:

process.observeSignal('SIGINT', () => {
	restoreTerminalState();
});

A passive observer would be notified when the signal arrives, but would not count as a handler, would not suppress Node's default behavior, and would not affect app ownership of signal handling. Apps that want to intercept or overrride shutdown would continue to use process.on(...).

This would give Node a clean separation between "tell me this happened" and "I am handling this". It solves a real problem for CLI and terminal libraries, reduces handler conflicts, preserves backward compatibility, and makes signal behavior more predictable across the ecosystem.

What alternatives have you considered?

Considered alternatives:

  1. Reuse process.on() / process.once()
    Rejected because it does not separate observation from handling. Libraries still become real signal handlers and can change global process behavior.

  2. Rely on exit hooks like exit / beforeExit
    Rejected because they are not signal-specific and are too late or inconsistent for cleanup that should happen when the signal is delivered.

  3. Tell libraries to avoid signals entirely
    Rejected because it pushes the problem onto every app and leaves reusable CLI libraries without a clean way to do best-effort cleanup.

  4. Add ordering, priority, or metadata to existing signal handlers
    Rejected because it may reduce conflicts, but it still treats passive observers as active handlers. Th core problem remains.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit der Prüfung von Nodes bestehender Signalbehandlung für process.on('SIGINT') und process.on('SIGTERM') sowie der im Issue beschriebenen Alternativen exit und beforeExit. Definiere, was ein passiver Beobachter anders tun muss als ein echter Handler, einschließlich der Beibehaltung des Standardverhaltens und der von der Anwendung definierten Zuständigkeit. Erledigt ist die Aufgabe, wenn die vorgeschlagene API und ihre Signal-Semantik so klar spezifiziert sind, dass sie implementiert werden können.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
javascript, node.js
Bereich
operating-systems
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.