Commit 651e7d2
doc: document http.IncomingMessage behaviour change
Add to the history table that the `destroyed` value returns `true` after
the incoming data is consumed.
Refs: #36617
Refs: #33035
PR-URL: #36641
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Robert Nagy <ronagy@icloud.com>1 parent eb6b386 commit 651e7d2
1 file changed
Lines changed: 9 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -1892,6 +1892,10 @@ the request body should be sent. | |||
| 1892 | 1892 | <!-- YAML | |
| 1893 | 1893 | added: v0.1.17 | |
| 1894 | 1894 | changes: | |
| 1895 | + - version: v15.5.0 | ||
| 1896 | + pr-url: https://github.com/nodejs/node/pull/33035 | ||
| 1897 | + description: The `destroyed` value returns `true` after the incoming data | ||
| 1898 | + is consumed. | ||
| 1895 | 1899 | - version: | |
| 1896 | 1900 | - v13.1.0 | |
| 1897 | 1901 | - v12.16.0 | |
@@ -1906,6 +1910,11 @@ An `IncomingMessage` object is created by [`http.Server`][] or | |||
| 1906 | 1910 | and [`'response'`][] event respectively. It may be used to access response | |
| 1907 | 1911 | status, headers and data. | |
| 1908 | 1912 | ||
| 1913 | + Different from it's `socket` value which is a subclass of {stream.Duplex}, the | ||
| 1914 | + `IncomingMessage` itself extends {stream.Readable} and is created separately to | ||
| 1915 | + parse and emit the incoming HTTP headers and payload, as the underlying socket | ||
| 1916 | + may be reused multiple times in case of keep-alive. | ||
| 1917 | + | ||
| 1909 | 1918 | ### Event: `'aborted'` | |
| 1910 | 1919 | <!-- YAML | |
| 1911 | 1920 | added: v0.3.8 | |
0 commit comments