Skip to content

Commit

Permalink
doc,test: clarify that Http2Stream is destroyed after data is read
Browse files Browse the repository at this point in the history
Correct docs to clarify that behaviour,
and fix a race condition in test-http2-large-write-destroy.js.

Fixes: #27863
PR-URL: #27891
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
  • Loading branch information
mildsunrise authored and targos committed May 31, 2019
1 parent 3ba354a commit 6cd64c8
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 2 deletions.
5 changes: 3 additions & 2 deletions doc/api/http2.md
Original file line number Diff line number Diff line change
Expand Up @@ -907,8 +907,9 @@ the value is `undefined`, the stream is not yet ready for use.

All [`Http2Stream`][] instances are destroyed either when:

* An `RST_STREAM` frame for the stream is received by the connected peer.
* The `http2stream.close()` method is called.
* An `RST_STREAM` frame for the stream is received by the connected peer,
and pending data has been read.
* The `http2stream.close()` method is called, and pending data has been read.
* The `http2stream.destroy()` or `http2session.destroy()` methods are called.

When an `Http2Stream` instance is destroyed, an attempt will be made to send an
Expand Down
1 change: 1 addition & 0 deletions test/parallel/test-http2-large-write-destroy.js
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ server.listen(0, common.mustCall(() => {

const req = client.request({ ':path': '/' });
req.end();
req.resume(); // Otherwise close won't be emitted if there's pending data.

req.on('close', common.mustCall(() => {
client.close();
Expand Down

0 comments on commit 6cd64c8

Please sign in to comment.