Commit 3f55dcd
doc: clarify process.title inconsistencies
Many users assume the act of assigning a value to `process.title` will
update the name of their application in apps like macOS Activity Monitor
or Windows Services Manager. This has worked in the past, but fails in
some versions of Node.js. Ultimately developers are left confused,
especially when it works in one version of Node.js and not another.
Given the recurring nature and complexity of the underlying problem, it
does not seem like a resolvable problem. This note clarifies the source
of the problem, sets developer expectations.
Refs: #28945
PR-URL: #34557
Fixes: #34280
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>1 parent 54a4c6a commit 3f55dcd
1 file changed
Lines changed: 6 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -2401,6 +2401,12 @@ allowed for longer process title strings by also overwriting the `environ` | |||
| 2401 | 2401 | memory but that was potentially insecure and confusing in some (rather obscure) | |
| 2402 | 2402 | cases. | |
| 2403 | 2403 | ||
| 2404 | + Assigning a value to `process.title` _may_ not reflect an accurate | ||
| 2405 | + (or any) label within the process manager application of the underlying | ||
| 2406 | + operating system (i.e. macOS Activity Monitor, Windows Services Manager, etc). | ||
| 2407 | + Inconsistencies and breaking changes within the _operating systems process | ||
| 2408 | + interface_ make synchronization with these applications unreliable. | ||
| 2409 | + | ||
| 2404 | 2410 | ## `process.traceDeprecation` | |
| 2405 | 2411 | <!-- YAML | |
| 2406 | 2412 | added: v0.8.0 | |
0 commit comments