Skip to content

Commit b689f03

Browse files
committed
v4 launch details
Signed-off-by: Matteo Collina <[email protected]>
1 parent 81c5264 commit b689f03

File tree

1 file changed

+41
-47
lines changed

1 file changed

+41
-47
lines changed

README.md

Lines changed: 41 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,38 @@
11
# readable-stream
22

3-
**_Node.js core streams for userland_**
3+
***Node.js core streams for userland***
44

5-
[![npm status](https://img.shields.io/npm/v/readable-stream.svg)](https://npm.im/readable-stream)
5+
[![npm status](http://img.shields.io/npm/v/readable-stream.svg)](https://www.npmjs.org/package/readable-stream)
66
[![node](https://img.shields.io/node/v/readable-stream.svg)](https://www.npmjs.org/package/readable-stream)
7-
[![Node.js Build](https://github.com/nodejs/readable-stream/workflows/Node.js/badge.svg)](https://github.com/nodejs/readable-stream/actions?query=workflow%3ANode.js)
8-
[![Browsers Build](https://github.com/nodejs/readable-stream/workflows/Browsers/badge.svg)](https://github.com/nodejs/readable-stream/actions?query=workflow%3ABrowsers)
7+
![Node.js](https://github.com/nodejs/readable-stream/workflows/Node.js/badge.svg?branch=master)
98

109
```bash
11-
npm install --save readable-stream
10+
npm install readable-stream
1211
```
1312

14-
This package is a mirror of the streams implementations in Node.js 18.0.0.
13+
This package is a mirror of the streams implementations in Node.js.
1514

16-
Full documentation may be found on the [Node.js website](https://nodejs.org/dist/v18.0.0/docs/api/stream.html).
15+
Full documentation may be found on the [Node.js website](https://nodejs.org/dist/v18.2.0/docs/api/stream.html).
1716

1817
If you want to guarantee a stable streams base, regardless of what version of
19-
Node you, or the users of your libraries are using, use **readable-stream** _only_ and avoid the _"stream"_ module in Node-core, for background see [this blogpost](http://r.va.gg/2014/06/why-i-dont-use-nodes-core-stream-module.html).
18+
Node you, or the users of your libraries are using, use **readable-stream** *only* and avoid the *"stream"* module in Node-core, for background see [this blogpost](http://r.va.gg/2014/06/why-i-dont-use-nodes-core-stream-module.html).
2019

2120
As of version 2.0.0 **readable-stream** uses semantic versioning.
2221

22+
## Version 4.x.x
23+
24+
v4.x.x of `readable-stream` is a cut from Node 18. This version supports Node 12, 14, 16 and 18, as well as evergreen browsers.
25+
The breaking changes introduced by v4 are composed by the combined breaking changes in
26+
* [Node v12](https://nodejs.org/en/blog/release/v12.0.0/)
27+
* [Node v13](https://nodejs.org/en/blog/release/v13.0.0/)
28+
* [Node v14](https://nodejs.org/en/blog/release/v14.0.0/)
29+
* [Node v15](https://nodejs.org/en/blog/release/v15.0.0/)
30+
* [Node v16](https://nodejs.org/en/blog/release/v16.0.0/)
31+
* [Node v17](https://nodejs.org/en/blog/release/v17.0.0/)
32+
* [Node v18](https://nodejs.org/en/blog/release/v18.0.0/)
33+
34+
This also include _many_ new features.
35+
2336
## Version 3.x.x
2437

2538
v3.x.x of `readable-stream` is a cut from Node 10. This version supports Node 6, 8, and 10, as well as evergreen browsers, IE 11 and latest Safari. The breaking changes introduced by v3 are composed by the combined breaking changes in [Node v9](https://nodejs.org/en/blog/release/v9.0.0/) and [Node v10](https://nodejs.org/en/blog/release/v10.0.0/), as follows:
@@ -46,7 +59,6 @@ v3.x.x of `readable-stream` is a cut from Node 10. This version supports Node 6,
4659
https://github.com/nodejs/node/pull/17979
4760

4861
## Version 2.x.x
49-
5062
v2.x.x of `readable-stream` is a cut of the stream module from Node 8 (there have been no semver-major changes from Node 4 to 8). This version supports all Node.js versions from 0.8, as well as evergreen browsers and IE 10 & 11.
5163

5264
# Usage
@@ -56,60 +68,42 @@ without any changes, if you are just using one of the main classes and
5668
functions.
5769

5870
```js
59-
const { Readable, Writable, Transform, Duplex, pipeline, finished } = require('readable-stream')
60-
```
71+
const {
72+
Readable,
73+
Writable,
74+
Transform,
75+
Duplex,
76+
pipeline,
77+
finished
78+
} = require('readable-stream')
79+
````
6180

6281
Note that `require('stream')` will return `Stream`, while
6382
`require('readable-stream')` will return `Readable`. We discourage using
6483
whatever is exported directly, but rather use one of the properties as
6584
shown in the example above.
6685

67-
## Usage In Browsers
68-
69-
You will need a bundler like [`browserify`](https://github.com/browserify/browserify#readme), [`webpack`](https://webpack.js.org/), [`parcel`](https://github.com/parcel-bundler/parcel#readme) or similar. With Webpack 5 (which unlike other bundlers does not polyfill Node.js core modules and globals like `process`) you will also need to:
70-
71-
1. Install polyfills by running `npm install buffer process --save-dev`
72-
2. Create a [`webpack.config.js`](https://webpack.js.org/guides/getting-started/#using-a-configuration) file containing:
73-
74-
```js
75-
const webpack = require('webpack')
76-
77-
module.exports = {
78-
plugins: [
79-
new webpack.ProvidePlugin({
80-
process: 'process/browser'
81-
})
82-
],
83-
resolve: {
84-
fallback: {
85-
buffer: require.resolve('buffer/')
86-
}
87-
}
88-
}
89-
```
90-
9186
# Streams Working Group
9287

9388
`readable-stream` is maintained by the Streams Working Group, which
9489
oversees the development and maintenance of the Streams API within
9590
Node.js. The responsibilities of the Streams Working Group include:
9691

97-
- Addressing stream issues on the Node.js issue tracker.
98-
- Authoring and editing stream documentation within the Node.js project.
99-
- Reviewing changes to stream subclasses within the Node.js project.
100-
- Redirecting changes to streams from the Node.js project to this
92+
* Addressing stream issues on the Node.js issue tracker.
93+
* Authoring and editing stream documentation within the Node.js project.
94+
* Reviewing changes to stream subclasses within the Node.js project.
95+
* Redirecting changes to streams from the Node.js project to this
10196
project.
102-
- Assisting in the implementation of stream providers within Node.js.
103-
- Recommending versions of `readable-stream` to be included in Node.js.
104-
- Messaging about the future of streams to give the community advance
97+
* Assisting in the implementation of stream providers within Node.js.
98+
* Recommending versions of `readable-stream` to be included in Node.js.
99+
* Messaging about the future of streams to give the community advance
105100
notice of changes.
106101

107102
<a name="members"></a>
108-
109103
## Team Members
110104

111-
- **Mathias Buus** ([@mafintosh](https://github.com/mafintosh)) &lt;[email protected]&gt;
112-
- **Matteo Collina** ([@mcollina](https://github.com/mcollina)) &lt;[email protected]&gt;
105+
* **Mathias Buus** ([@mafintosh](https://github.com/mafintosh)) &lt;[email protected]&gt;
106+
* **Matteo Collina** ([@mcollina](https://github.com/mcollina)) &lt;[email protected]&gt;
113107
- Release GPG key: 3ABC01543F22DD2239285CDD818674489FBC127E
114-
- **Robert Nagy** ([@ronag](https://github.com/ronag)) &lt;[email protected]&gt;
115-
- **Vincent Weevers** ([@vweevers](https://github.com/vweevers)) &lt;[email protected]&gt;
108+
* **Robert Nagy** ([@ronag](https://github.com/ronag)) &lt;[email protected]&gt;
109+
* **Vincent Weevers** ([@vweevers](https://github.com/vweevers)) &lt;[email protected]&gt;

0 commit comments

Comments
 (0)