Node.js Stream writable.destroy() 方法

writable.destroy() 方法是 Node.js 中可写流（writable stream）的一个方法。它用于立即关闭可写流，并阻止进一步的写入操作。在这个介绍中，我们将详细了解该方法的功能和用法。

语法

以下是 writable.destroy() 方法的语法：

writable.destroy([error])

• error：一个可选的 Error 对象，用于指定关闭流时的错误信息。

功能

writable.destroy() 方法用于关闭可写流。当调用该方法时，流将立即停止写入，并触发 finish 事件。此后，流将被销毁，不再可写。还将触发 close 事件，以表示流的关闭。

如果提供了 error 参数，则会触发 error 事件，并将错误对象作为参数传递给相应的事件处理程序。否则，不会触发 error 事件。

可写流的 destroy() 方法与 end() 方法不同。destroy() 方法立即终止写入并关闭流，而 end() 方法则会完成当前的写入操作然后关闭流。

示例

以下示例展示了如何使用 writable.destroy() 方法关闭可写流：

const fs = require('fs');

const writable = fs.createWriteStream('file.txt');

writable.destroy(new Error('Stream destroyed'));

writable.on('finish', () => {
    console.log('Stream finished');
});

writable.on('error', (err) => {
    console.error('Stream error:', err);
});

writable.on('close', () => {
    console.log('Stream closed');
});

上述代码中，我们创建了一个可写流并将其指定到一个名为 file.txt 的文件中。然后，我们调用 writable.destroy() 方法来立即关闭流，并传递一个错误对象作为参数。在此之后，会触发 finish 事件和 error 事件，并打印相应的消息。

结论

通过 writable.destroy() 方法，我们可以立即关闭可写流，并停止进一步的写入操作。这对于我们需要提前关闭流的场景非常有用。务必注意，在关闭流之后，将无法再进行写入操作。