Cet article vous présentera le module stream Node et vous expliquera comment utiliser Stream pour créer des applications Node.js hautes performances. J'espère qu'il sera utile à tout le monde !
Lorsque vous tapez des caractères sur le clavier, lisez un fichier à partir d'un disque ou téléchargez un fichier depuis Internet, un flux d'informations (bits) circule à travers différents appareils et applications.
Si vous apprenez à traiter ces flux d'octets, vous serez en mesure de créer des applications performantes et précieuses. Par exemple, imaginez que lorsque vous regardez une vidéo sur YouTube, vous n’avez pas besoin d’attendre le téléchargement complet de la vidéo. Une fois qu'il y aura un petit tampon, la lecture de la vidéo commencera et le reste continuera à être téléchargé pendant que vous regardez.
Nodejs inclut un module intégré stream qui nous permet de traiter les données en streaming. Dans cet article, nous expliquerons l'utilisation de stream à travers plusieurs exemples simples. Nous décrirons également comment créer des pipelines pour fusionner différents flux lors de la création d'applications hautes performances dans des cas complexes. stream 可以让我们处理流数据。在这篇文章中，我们将通过几个简单的示例来讲解 stream 的用法，我们也会描述在面对复杂案例构建高性能应用时，应该如何构建管道去合并不同的流。
在我们深入理解应用构建前，理解 Node.js stream 模块提供的特性很重要。
让我们开始吧！
Node.js stream 提供了四种类型的流
更多详情请查看 Node.js 官方文档
https://nodejs.org/api/stream.html#stream_types_of_streams
让我们在高层面来看看每一种流类型吧。
可读流可以从一个特定的数据源中读取数据，最常见的是从一个文件系统中读取。Node.js 应用中其他常见的可读流用法有：
process.stdin -通过 stdin 在终端应用中读取用户输入。http.IncomingMessage - 在 HTTP 服务中读取传入的请求内容或者在 HTTP 客户端中读取服务器的 HTTP 响应。你可以使用可写流将来自应用的数据写入到特定的地方，比如一个文件。
process.stdout 可以用来将数据写成标准输出且被 console.log 内部使用。
接下来是双工流和转换流，可以被定义为基于可读流和可写流的混合流类型。
双工流是可读流和可写流的结合，它既可以将数据写入到特定的地方也可以从数据源读取数据。最常见的双工流案例是 net.Socket，它被用来从 socket 读写数据。
有一点很重要，双工流中的可读端和可写端的操作是相互独立的，数据不会从一端流向另一端。
转换流与双工流略有相似，但在转换流中，可读端和可写端是相关联的。
crypto.Cipher 类是一个很好的例子，它实现了加密流。通过 crypto.Cipher 流，应用可以往流的可写端写入纯文本数据并从流的可读端读取加密后的密文。之所以将这种类型的流称之为转换流就是因为其转换性质。
附注：另一个转换流是 stream.PassThrough。stream.PassThrough 从可写端传递数据到可读端，没有任何转换。这听起来可能有点多余，但 Passthrough 流对构建自定义流以及流管道非常有帮助。（比如创建一个流的数据的多个副本）
一旦可读流连接到生产数据的源头，比如一个文件，就可以用几种方法通过该流读取数据。
首先，先创建一个名为 myfile 的简单的 text 文件，85 字节大小，包含以下字符串：
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur nec mauris turpis.
现在，我们看下从可读流读取数据的两种不同方式。
data 事件从可读流读取数据的最常见方式是监听流发出的 data 事件。以下代码演示了这种方式：
const fs = require('fs')
const readable = fs.createReadStream('./myfile', { highWaterMark: 20 });
readable.on('data', (chunk) => {
console.log(`Read ${chunk.length} bytes\n"${chunk.toString()}"\n`);
})highWaterMark 属性作为一个选项传递给 fs.createReadStream，用于决定该流中有多少数据缓冲。然后数据被冲到读取机制（在这个案例中，是我们的 data 处理程序）。默认情况下，可读 fs 流的 highWaterMark 值是 64kb。我们刻意重写该值为 20 字节用于触发多个 data
stream de Node.js. 🎜🎜Commençons ! 🎜stream fournit quatre types de flux🎜 🎜Pour plus de détails, veuillez consulter la documentation officielle de Node.js🎜🎜https://nodejs.org/api/stream.html#stream_types_of_streams🎜🎜Regardons chacun type de débit à un niveau élevé. 🎜
process.stdin - Lecture des entrées utilisateur dans une application de terminal via stdin. http.IncomingMessage - Lit le contenu d'une requête entrante dans un serveur HTTP ou lit la réponse HTTP du serveur dans un client HTTP. process.stdout peut être utilisé pour écrire des données sur la sortie standard et est utilisé en interne par console.log. 🎜🎜Vient ensuite les flux duplex et les flux de transformation, qui peuvent être définis comme des types de flux hybrides basés sur des flux lisibles et des flux inscriptibles. 🎜net.Socket, qui est utilisé pour lire et écrire des données à partir d'un socket. 🎜🎜Il est important de noter que les opérations de l'extrémité lisible et de l'extrémité inscriptible du flux duplex sont indépendantes l'une de l'autre et que les données ne circuleront pas d'une extrémité à l'autre. 🎜crypto.Cipher est un bon exemple, elle implémente des flux cryptés. Grâce au flux crypto.Cipher, les applications peuvent écrire des données en texte brut à l'extrémité inscriptible du flux et lire le texte chiffré à partir de l'extrémité lisible du flux. Ce type de flux est appelé flux de conversion en raison de ses propriétés de conversion. 🎜🎜P.S. : Un autre flux de transformation est stream.PassThrough. stream.PassThrough transmet les données du côté inscriptible au côté lisible sans aucune conversion. Cela peut sembler redondant, mais les flux Passthrough sont très utiles pour créer des flux personnalisés ainsi que des pipelines de flux. (par exemple, créer plusieurs copies des données d'un flux) 🎜myfile, d'une taille de 85 octets, contenant la chaîne suivante : 🎜Read 20 bytes "Lorem ipsum dolor si" Read 20 bytes "t amet, consectetur " Read 20 bytes "adipiscing elit. Cur" Read 20 bytes "abitur nec mauris tu" Read 5 bytes "rpis."
datadata émis par le flux. Le code suivant illustre cette approche : 🎜const fs = require('fs')
const readable = fs.createReadStream('./myfile', { highWaterMark: 20 });
(async () => {
for await (const chunk of readable) {
console.log(`Read ${chunk.length} bytes\n"${chunk.toString()}"\n`);
}
})()highWaterMark est transmise à fs.createReadStream comme option pour déterminer la quantité de données mises en mémoire tampon dans le flux. Les données sont ensuite transmises au mécanisme de lecture (dans ce cas, notre gestionnaire data). Par défaut, la valeur highWaterMark pour un flux fs lisible est de 64 Ko. Nous réécrivons intentionnellement cette valeur à 20 octets pour déclencher plusieurs événements data. 🎜如果你运行上述程序，它会在五个迭代内从 myfile 中读取 85 个字节。你会在 console 看到以下输出：
Read 20 bytes "Lorem ipsum dolor si" Read 20 bytes "t amet, consectetur " Read 20 bytes "adipiscing elit. Cur" Read 20 bytes "abitur nec mauris tu" Read 5 bytes "rpis."
从可读流中读取数据的另一种方法是使用异步迭代器：
const fs = require('fs')
const readable = fs.createReadStream('./myfile', { highWaterMark: 20 });
(async () => {
for await (const chunk of readable) {
console.log(`Read ${chunk.length} bytes\n"${chunk.toString()}"\n`);
}
})()如果你运行这个程序，你会得到和前面例子一样的输出。
当一个监听器监听到可读流的 data 事件时，流的状态会切换成”流动”状态（除非该流被显式的暂停了）。你可以通过流对象的 readableFlowing 属性检查流的”流动”状态
我们可以稍微修改下前面的例子，通过 data 处理器来示范：
const fs = require('fs')
const readable = fs.createReadStream('./myfile', { highWaterMark: 20 });
let bytesRead = 0
console.log(`before attaching 'data' handler. is flowing: ${readable.readableFlowing}`);
readable.on('data', (chunk) => {
console.log(`Read ${chunk.length} bytes`);
bytesRead += chunk.length
// 在从可读流中读取 60 个字节后停止阅读
if (bytesRead === 60) {
readable.pause()
console.log(`after pause() call. is flowing: ${readable.readableFlowing}`);
// 在等待 1 秒后继续读取
setTimeout(() => {
readable.resume()
console.log(`after resume() call. is flowing: ${readable.readableFlowing}`);
}, 1000)
}
})
console.log(`after attaching 'data' handler. is flowing: ${readable.readableFlowing}`);在这个例子中，我们从一个可读流中读取 myfile，但在读取 60 个字节后，我们临时暂停了数据流 1 秒。我们也在不同的时间打印了 readableFlowing 属性的值去理解他是如何变化的。
如果你运行上述程序，你会得到以下输出：
before attaching 'data' handler. is flowing: null after attaching 'data' handler. is flowing: true Read 20 bytes Read 20 bytes Read 20 bytes after pause() call. is flowing: false after resume() call. is flowing: true Read 20 bytes Read 5 bytes
我们可以用以下来解释输出：
当我们的程序开始时，readableFlowing 的值是 null，因为我们没有提供任何消耗流的机制。
在连接到 data 处理器后，可读流变为“流动”模式，readableFlowing 变为 true。
一旦读取 60 个字节，通过调用 pause()来暂停流，readableFlowing 也转变为 false。
在等待 1 秒后，通过调用 resume()，流再次切换为“流动”模式，readableFlowing 改为 `true'。然后剩下的文件内容在流中流动。
因为有流，应用不需要在内存中保留大型的二进制对象：小型的数据块可以接收到就进行处理。
在这部分，让我们组合不同的流来构建一个可以处理大量数据的真实应用。我们会使用一个小型的工具程序来生成一个给定文件的 SHA-256。
但首先，我们需要创建一个大型的 4GB 的假文件来测试。你可以通过一个简单的 shell 命令来完成：
mkfile -n 4g 4gb_filexfs_mkfile 4096m 4gb_file在我们创建了假文件 4gb_file 后，让我们在不使用 stream 模块的情况下来生成来文件的 SHA-256 hash。
const fs = require("fs");
const crypto = require("crypto");
fs.readFile("./4gb_file", (readErr, data) => {
if (readErr) return console.log(readErr)
const hash = crypto.createHash("sha256").update(data).digest("base64");
fs.writeFile("./checksum.txt", hash, (writeErr) => {
writeErr && console.error(err)
});
});如果你运行以上代码，你可能会得到以下错误：
RangeError [ERR_FS_FILE_TOO_LARGE]: File size (4294967296) is greater than 2 GB
at FSReqCallback.readFileAfterStat [as oncomplete] (fs.js:294:11) {
code: 'ERR_FS_FILE_TOO_LARGE'
}以上报错之所以发生是因为 JavaScript 运行时无法处理随机的大型缓冲。运行时可以处理的最大尺寸的缓冲取决于你的操作系统结构。你可以通过使用内建的 buffer 模块里的 buffer.constants.MAX_LENGTH 变量来查看你操作系统缓存的最大尺寸。
即使上述报错没有发生，在内存中保留大型文件也是有问题的。我们所拥有的可用的物理内存会限制我们应用能使用的内存量。高内存使用率也会造成应用在 CPU 使用方面性能低下，因为垃圾回收会变得昂贵。
pipeline() 减少 APP 的内存占用现在，让我们看看如何修改应用去使用流且避免遇到这个报错：
const fs = require("fs");
const crypto = require("crypto");
const { pipeline } = require("stream");
const hashStream = crypto.createHash("sha256");
hashStream.setEncoding('base64')
const inputStream = fs.createReadStream("./4gb_file");
const outputStream = fs.createWriteStream("./checksum.txt");
pipeline(
inputStream,
hashStream,
outputStream,
(err) => {
err && console.error(err)
}
)在这个例子中，我们使用 crypto.createHash 函数提供的流式方法。它返回一个“转换”流对象 hashStream，为随机的大型文件生成 hash。
为了将文件内容传输到这个转换流中，我们使用 fs.createReadStream 为 4gb_file 创建了一个可读流 inputStream。我们将 hashStream 转换流的输出传递到可写流 outputStream 中，而 checksum.txt 通过 fs.createWriteStream 创建的。
如果你运行以上程序，你将看见在 checksum.txt 文件中看见 4GB 文件的 SHA-256 hash。
pipeline() 和 pipe() 的对比在前面的案例中，我们使用 pipeline 函数来连接多个流。另一种常见的方法是使用 .pipe() 函数，如下所示：
inputStream .pipe(hashStream) .pipe(outputStream)
但这里有几个原因，所以并不推荐在生产应用中使用 .pipe()。如果其中一个流被关闭或者出现报错，pipe() 不会自动销毁连接的流，这会导致应用内存泄露。同样的，pipe() 不会自动跨流转发错误到一个地方处理。
因为这些问题，所以就有了 pipeline()，所以推荐你使用 pipeline() 而不是 pipe() 来连接不同的流。 我们可以重写上述的 pipe() 例子来使用 pipeline() 函数，如下：
pipeline(
inputStream,
hashStream,
outputStream,
(err) => {
err && console.error(err)
}
)pipeline() 接受一个回调函数作为最后一个参数。任何来自被连接的流的报错都将触发该回调函数，所以可以很轻松的在一个地方处理报错。
在 Node.js 中使用流有助于我们构建可以处理大型数据的高性能应用。
在这篇文章中，我们覆盖了：
data 事件或者使用异步迭代器来从可读流中读取数据。pipeline 连接多个流来减少内存占用。一个简短的警告：你很可能不会遇到太多必须使用流的场景，而基于流的方案会提高你的应用的复杂性。务必确保使用流的好处胜于它所带来的复杂性。
更多node相关知识，请访问：nodejs 教程！
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!
débogage node.js
La différence entre ancrer et viser
Solutions aux caractères chinois tronqués
La visionneuse d'images Windows ne peut pas afficher une mémoire insuffisante
Comment convertir du HTML au format texte txt
Tutoriel CakePHP
Comment être invisible en ligne sur TikTok
Comment vérifier les enregistrements d'appels supprimés
![[Web front-end] Démarrage rapide de Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
