Skip to content

Commit

Permalink
doc: add steam pipelining note on Http usage
Browse files Browse the repository at this point in the history
  • Loading branch information
RafaelGSS committed Jan 31, 2022
1 parent 4fbe9e5 commit fb8c5a9
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions doc/api/stream.md
Original file line number Diff line number Diff line change
Expand Up @@ -2517,6 +2517,28 @@ run().catch(console.error);
after the `callback` has been invoked. In the case of reuse of streams after
failure, this can cause event listener leaks and swallowed errors.

`stream.pipeline()` closes all the streams when an error is raised.
The `IncomingRequest` usage with `pipeline` could lead to an unexpected behavior
once it would destroy the socket without sending the expected response.
See the example below:

```js
const fs = require('fs')
const http = require('http')
const { pipeline } = require('stream')

const server = http.createServer((req, res) => {
const fileStream = fs.createReadStream('./fileNotExist.txt')
pipeline(fileStream, res, (err) => {
if (err) {
console.log(err) // No such file
// this message can't be sent once `pipeline` already destroyed the socket
return res.end("error!!!");
}
})
})
```

### `stream.compose(...streams)`

<!-- YAML
Expand Down

0 comments on commit fb8c5a9

Please sign in to comment.