GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing github.com — doc: deprecate http finished · nodejs/node@ec514a6

File tree

Expand file treeCollapse file tree

Open diff view settings

Filter options

doc/api

Expand file treeCollapse file tree

Open diff view settings

Collapse file

`‎doc/api/deprecations.md‎`

Copy file name to clipboardExpand all lines: doc/api/deprecations.md

+25Lines changed: 25 additions & 0 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
@@ -2521,6 +2521,27 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
`2521`	`2521`	The `process._tickCallback` property was never documented as
`2522`	`2522`	`an officially supported API.`
`2523`	`2523`
	`2524`	`+<a id="DEP0136"></a>`
	`2525`	+### DEP0136: `http` `finished`
	`2526`	`+<!-- YAML`
	`2527`	`+changes:`
	`2528`	`+ - version: REPLACEME`
	`2529`	`+ pr-url: https://github.com/nodejs/node/pull/28679`
	`2530`	`+ description: Documentation-only deprecation.`
	`2531`	`+-->`
	`2532`	`+`
	`2533`	`+Type: Documentation-only`
	`2534`	`+`
	`2535`	+[`response.finished`][] indicates whether [`response.end()`][] has been
	`2536`	+called, not whether `'finish'` has been emitted and the underlying data
	`2537`	`+is flushed.`
	`2538`	`+`
	`2539`	+Use [`response.writableFinished`][] or [`response.writableEnded`][]
	`2540`	`+accordingly instead to avoid the ambigiuty.`
	`2541`	`+`
	`2542`	+To maintain existing behaviour `response.finished` should be replaced with
	`2543`	+`response.writableEnded`.
	`2544`	`+`
`2524`	`2545`	[`--http-parser=legacy`]: cli.html#cli_http_parser_library
`2525`	`2546`	[`--pending-deprecation`]: cli.html#cli_pending_deprecation
`2526`	`2547`	[`--throw-deprecation`]: cli.html#cli_throw_deprecation
`@@ -2580,6 +2601,10 @@ an officially supported API.`
`2580`	`2601`	[`request.connection`]: http.html#http_request_connection
`2581`	`2602`	[`response.socket`]: http.html#http_response_socket
`2582`	`2603`	[`response.connection`]: http.html#http_response_connection
	`2604`	+[`response.end()`]: http.html#http_response_end_data_encoding_callback
	`2605`	+[`response.finished`]: #http_response_finished
	`2606`	+[`response.writableFinished`]: #http_response_writablefinished
	`2607`	+[`response.writableEnded`]: #http_response_writableended
`2583`	`2608`	[`script.createCachedData()`]: vm.html#vm_script_createcacheddata
`2584`	`2609`	[`setInterval()`]: timers.html#timers_setinterval_callback_delay_args
`2585`	`2610`	[`setTimeout()`]: timers.html#timers_settimeout_callback_delay_args

Collapse file

`‎doc/api/http.md‎`

Copy file name to clipboardExpand all lines: doc/api/http.md

+8Lines changed: 8 additions & 0 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
`@@ -620,8 +620,11 @@ is finished.`
`620`	`620`	### `request.finished`
`621`	`621`	`<!-- YAML`
`622`	`622`	`added: v0.0.1`
	`623`	`+deprecated: REPLACEME`
`623`	`624`	`-->`
`624`	`625`
	`626`	+> Stability: 0 - Deprecated. Use [`request.writableEnded`][].
	`627`	`+`
`625`	`628`	`* {boolean}`
`626`	`629`
`627`	`630`	The `request.finished` property will be `true` if [`request.end()`][]
`@@ -1297,8 +1300,11 @@ is finished.`
`1297`	`1300`	### `response.finished`
`1298`	`1301`	`<!-- YAML`
`1299`	`1302`	`added: v0.0.2`
	`1303`	`+deprecated: REPLACEME`
`1300`	`1304`	`-->`
`1301`	`1305`
	`1306`	+> Stability: 0 - Deprecated. Use [`response.writableEnded`][].
	`1307`	`+`
`1302`	`1308`	`* {boolean}`
`1303`	`1309`
`1304`	`1310`	The `response.finished` property will be `true` if [`response.end()`][]
@@ -2353,12 +2359,14 @@ not abort the request or do anything besides add a `'timeout'` event.
`2353`	`2359`	[`request.socket.getPeerCertificate()`]: tls.html#tls_tlssocket_getpeercertificate_detailed
`2354`	`2360`	[`request.socket`]: #http_request_socket
`2355`	`2361`	[`request.writableFinished`]: #http_request_writablefinished
	`2362`	+[`request.writableEnded`]: #http_request_writableended
`2356`	`2363`	[`request.write(data, encoding)`]: #http_request_write_chunk_encoding_callback
`2357`	`2364`	[`response.end()`]: #http_response_end_data_encoding_callback
`2358`	`2365`	[`response.getHeader()`]: #http_response_getheader_name
`2359`	`2366`	[`response.setHeader()`]: #http_response_setheader_name_value
`2360`	`2367`	[`response.socket`]: #http_response_socket
`2361`	`2368`	[`response.writableFinished`]: #http_response_writablefinished
	`2369`	+[`response.writableEnded`]: #http_response_writableended
`2362`	`2370`	[`response.write()`]: #http_response_write_chunk_encoding_callback
`2363`	`2371`	[`response.write(data, encoding)`]: #http_response_write_chunk_encoding_callback
`2364`	`2372`	[`response.writeContinue()`]: #http_response_writecontinue

Collapse file

`‎doc/api/http2.md‎`

Copy file name to clipboardExpand all lines: doc/api/http2.md

+4Lines changed: 4 additions & 0 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
`@@ -3091,8 +3091,11 @@ is finished.`
`3091`	`3091`	#### `response.finished`
`3092`	`3092`	`<!-- YAML`
`3093`	`3093`	`added: v8.4.0`
	`3094`	`+deprecated: REPLACEME`
`3094`	`3095`	`-->`
`3095`	`3096`
	`3097`	+> Stability: 0 - Deprecated. Use [`response.writableEnded`][].
	`3098`	`+`
`3096`	`3099`	`* {boolean}`
`3097`	`3100`
`3098`	`3101`	`Boolean value that indicates whether the response has completed. Starts`
`@@ -3576,6 +3579,7 @@ following additional properties:`
`3576`	`3579`	[`response.end()`]: #http2_response_end_data_encoding_callback
`3577`	`3580`	[`response.setHeader()`]: #http2_response_setheader_name_value
`3578`	`3581`	[`response.socket`]: #http2_response_socket
	`3582`	+[`response.writableEnded`]: #http2_response_writableended
`3579`	`3583`	[`response.write()`]: #http2_response_write_chunk_encoding_callback
`3580`	`3584`	[`response.write(data, encoding)`]: http.html#http_response_write_chunk_encoding_callback
`3581`	`3585`	[`response.writeContinue()`]: #http2_response_writecontinue

0 commit comments

Comments

0 (0)

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.