stream: propagate AbortSignal reason

[marvinroger]

This PR propagates the reason of the AbortSignal passed to the pipeline function (node:stream/promises) to the cause of the thrown AbortError.

The vast majority of AbortErrors created by the standard library already propagates the reason, so this should bring more consistency.

[nodejs-github-bot]

Review requested:

• @nodejs/streams

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/63221/

[RedYetiDev]

Thanks for the contribution! Unfortunately, your first commit doesn't follow the guidelines set in place. Could you amend it?

In this case, stream is the most appropriate subsystem. stream: ...

[marvinroger]

There you go @RedYetiDev! 😉

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/63223/

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.40%. Comparing base (b0ffe9e) to head (ed0d894).
Report is 15 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #55473      +/-   ##
==========================================
- Coverage   88.42%   88.40%   -0.02%     
==========================================
  Files         653      653              
  Lines      187498   187498              
  Branches    36100    36108       +8     
==========================================
- Hits       165791   165762      -29     
- Misses      14957    14965       +8     
- Partials     6750     6771      +21     

Files with missing lines	Coverage Δ
lib/internal/streams/pipeline.js	95.12% <100.00%> (ø)

... and 28 files with indirect coverage changes

[mcollina]

lgtm

Can you add it to the docs as well?

[marvinroger]

@mcollina I did not add it to the docs initially as it's the continuation of #41008, where no docs were updated, and it's now pretty much the expected behavior. greping the codebase reveals almost no instance of new AbortError() (except in streams, I'll do a follow up PR to fix the others, it's my first contribution and I wanted to see how it goes with a small PR). greping new AbortError(undefined, { cause: signal.reason reveals 33 results.

However, if you think it's still worth it to add it to the docs, I'll do!