Commit 1233e92
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -3272,21 +3272,22 @@ Convert them to primitive strings. | |||
| 3272 | 3272 | ||
| 3273 | 3273 | <!-- YAML | |
| 3274 | 3274 | changes: | |
| 3275 | + - version: REPLACEME | ||
| 3276 | + pr-url: https://github.com/nodejs/node/pull/59758 | ||
| 3277 | + description: Deprecation revoked. | ||
| 3275 | 3278 | - version: | |
| 3276 | 3279 | - v18.7.0 | |
| 3277 | 3280 | - v16.17.0 | |
| 3278 | 3281 | pr-url: https://github.com/nodejs/node/pull/42714 | |
| 3279 | 3282 | description: Documentation-only deprecation. | |
| 3280 | 3283 | --> | |
| 3281 | 3284 | ||
| 3282 | - Type: Documentation-only | ||
| 3283 | - | ||
| 3284 | - These methods were deprecated because they can be used in a way which does not | ||
| 3285 | - hold the channel reference alive long enough to receive the events. | ||
| 3285 | + Type: Deprecation revoked | ||
| 3286 | 3286 | ||
| 3287 | - Use [`diagnostics_channel.subscribe(name, onMessage)`][] or | ||
| 3288 | - [`diagnostics_channel.unsubscribe(name, onMessage)`][] which does the same | ||
| 3289 | - thing instead. | ||
| 3287 | + These methods were deprecated because their use could leave the channel object | ||
| 3288 | + vulnerable to being garbage-collected if not strongly referenced by the user. | ||
| 3289 | + The deprecation was revoked because channel objects are now resistant to | ||
| 3290 | + garbage collection when the channel has active subscribers. | ||
| 3290 | 3291 | ||
| 3291 | 3292 | ### DEP0164: `process.exit(code)`, `process.exitCode` coercion to integer | |
| 3292 | 3293 | ||
@@ -3930,8 +3931,6 @@ an internal nodejs implementation rather than a public facing API, use `node:htt | |||
| 3930 | 3931 | [`crypto.setEngine()`]: crypto.md#cryptosetengineengine-flags | |
| 3931 | 3932 | [`decipher.final()`]: crypto.md#decipherfinaloutputencoding | |
| 3932 | 3933 | [`decipher.setAuthTag()`]: crypto.md#deciphersetauthtagbuffer-encoding | |
| 3933 | - [`diagnostics_channel.subscribe(name, onMessage)`]: diagnostics_channel.md#diagnostics_channelsubscribename-onmessage | ||
| 3934 | - [`diagnostics_channel.unsubscribe(name, onMessage)`]: diagnostics_channel.md#diagnostics_channelunsubscribename-onmessage | ||
| 3935 | 3934 | [`dirent.parentPath`]: fs.md#direntparentpath | |
| 3936 | 3935 | [`dirent.path`]: fs.md#direntpath | |
| 3937 | 3936 | [`dns.lookup()`]: dns.md#dnslookuphostname-options-callback | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -373,13 +373,17 @@ channel.publish({ | |||
| 373 | 373 | added: | |
| 374 | 374 | - v15.1.0 | |
| 375 | 375 | - v14.17.0 | |
| 376 | - deprecated: | ||
| 377 | - - v18.7.0 | ||
| 378 | - - v16.17.0 | ||
| 376 | + changes: | ||
| 377 | + - version: REPLACEME | ||
| 378 | + pr-url: https://github.com/nodejs/node/pull/59758 | ||
| 379 | + description: Deprecation revoked. | ||
| 380 | + - version: | ||
| 381 | + - v18.7.0 | ||
| 382 | + - v16.17.0 | ||
| 383 | + pr-url: https://github.com/nodejs/node/pull/44943 | ||
| 384 | + description: Documentation-only deprecation. | ||
| 379 | 385 | --> | |
| 380 | 386 | ||
| 381 | - > Stability: 0 - Deprecated: Use [`diagnostics_channel.subscribe(name, onMessage)`][] | ||
| 382 | - | ||
| 383 | 387 | * `onMessage` {Function} The handler to receive channel messages | |
| 384 | 388 | * `message` {any} The message data | |
| 385 | 389 | * `name` {string|symbol} The name of the channel | |
@@ -414,10 +418,15 @@ channel.subscribe((message, name) => { | |||
| 414 | 418 | added: | |
| 415 | 419 | - v15.1.0 | |
| 416 | 420 | - v14.17.0 | |
| 417 | - deprecated: | ||
| 418 | - - v18.7.0 | ||
| 419 | - - v16.17.0 | ||
| 420 | 421 | changes: | |
| 422 | + - version: REPLACEME | ||
| 423 | + pr-url: https://github.com/nodejs/node/pull/59758 | ||
| 424 | + description: Deprecation revoked. | ||
| 425 | + - version: | ||
| 426 | + - v18.7.0 | ||
| 427 | + - v16.17.0 | ||
| 428 | + pr-url: https://github.com/nodejs/node/pull/44943 | ||
| 429 | + description: Documentation-only deprecation. | ||
| 421 | 430 | - version: | |
| 422 | 431 | - v17.1.0 | |
| 423 | 432 | - v16.14.0 | |
@@ -426,8 +435,6 @@ changes: | |||
| 426 | 435 | description: Added return value. Added to channels without subscribers. | |
| 427 | 436 | --> | |
| 428 | 437 | ||
| 429 | - > Stability: 0 - Deprecated: Use [`diagnostics_channel.unsubscribe(name, onMessage)`][] | ||
| 430 | - | ||
| 431 | 438 | * `onMessage` {Function} The previous subscribed handler to remove | |
| 432 | 439 | * Returns: {boolean} `true` if the handler was found, `false` otherwise. | |
| 433 | 440 | ||
@@ -1422,7 +1429,6 @@ Emitted when a new thread is created. | |||
| 1422 | 1429 | [`diagnostics_channel.channel(name)`]: #diagnostics_channelchannelname | |
| 1423 | 1430 | [`diagnostics_channel.subscribe(name, onMessage)`]: #diagnostics_channelsubscribename-onmessage | |
| 1424 | 1431 | [`diagnostics_channel.tracingChannel()`]: #diagnostics_channeltracingchannelnameorchannels | |
| 1425 | - [`diagnostics_channel.unsubscribe(name, onMessage)`]: #diagnostics_channelunsubscribename-onmessage | ||
| 1426 | 1432 | [`end` event]: #endevent | |
| 1427 | 1433 | [`error` event]: #errorevent | |
| 1428 | 1434 | [`net.Server.listen()`]: net.md#serverlisten | |
0 commit comments