doc: document breaking change in http.IncomingMessage 'close' event

ShogunPanda · juanarbol · commit fd45df314b28 · 2022-04-06T12:25:50.000-05:00
PR-URL: #42521 Fixes: #38924 Refs: #33035 Reviewed-By: Robert Nagy <ronagy@icloud.com> Reviewed-By: Beth Griggs <bgriggs@redhat.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -2106,9 +2106,14 @@ Emitted when the request has been aborted.
 
 <!-- YAML
 added: v0.4.2
+changes:
+  - version: v16.0.0
+    pr-url: https://github.com/nodejs/node/pull/33035
+    description: The close event is now emitted when the request has been completed and not when the
+                 underlying socket is closed.
 -->
 
-Indicates that the underlying connection was closed.
+Emitted when the request has been completed.
 
 ### `message.aborted`
 
diff --git a/doc/changelogs/CHANGELOG_V16.md b/doc/changelogs/CHANGELOG_V16.md
@@ -1600,6 +1600,7 @@ Contributed by Michaël Zasso - [#37587](https://github.com/nodejs/node/pull/375
 * **deps**: update llhttp to 6.0.0 (Fedor Indutny) [#38277](https://github.com/nodejs/node/pull/38277)
 * **deps**: upgrade npm to 7.10.0 (Ruy Adorno) [#38254](https://github.com/nodejs/node/pull/38254)
 * **(SEMVER-MINOR)** **http**: add http.ClientRequest.getRawHeaderNames() (simov) [#37660](https://github.com/nodejs/node/pull/37660)
+* **(SEMVER-MAJOR)** **http**: use `autoDestroy: true` in incoming message (Daniele Belardi) [#33035](https://github.com/nodejs/node/pull/33035)
 * **(SEMVER-MAJOR)** **lib,src**: update cluster to use Parent (Michael Dawson) [#36478](https://github.com/nodejs/node/pull/36478)
 * **(SEMVER-MINOR)** **module**: add support for `node:`‑prefixed `require(…)` calls (ExE Boss) [#37246](https://github.com/nodejs/node/pull/37246)
 * **(SEMVER-MINOR)** **perf\_hooks**: add histogram option to timerify (James M Snell) [#37475](https://github.com/nodejs/node/pull/37475)
