Node.js stream.Writable.destroy([error])用法及代碼示例

writable.destroy([error])

參數

• error <Error> 可選，使用 'error' 事件發出錯誤。
• 返回： <this>

銷毀流。可選擇發出 'error' 事件，並發出 'close' 事件(除非 emitClose 設置為 false )。在此調用之後，可寫流已結束，隨後對 write() 或 end() 的調用將導致 ERR_STREAM_DESTROYED 錯誤。這是一種破壞性的直接破壞流的方法。以前對 write() 的調用可能尚未耗盡，並且可能會觸發 ERR_STREAM_DESTROYED 錯誤。如果數據應該在關閉之前刷新，則使用end() 而不是destroy，或者在銷毀流之前等待'drain' 事件。

const { Writable } = require('node:stream');

const myStream = new Writable();

const fooErr = new Error('foo error');
myStream.destroy(fooErr);
myStream.on('error', (fooErr) => console.error(fooErr.message)); // foo error

const { Writable } = require('node:stream');

const myStream = new Writable();

myStream.destroy();
myStream.on('error', function wontHappen() {});

const { Writable } = require('node:stream');

const myStream = new Writable();
myStream.destroy();

myStream.write('foo', (error) => console.error(error.code));
// ERR_STREAM_DESTROYED

一旦 destroy() 被調用，任何進一步的調用都將是 no-op 並且除了來自 _destroy() 之外的任何其他錯誤都不會作為 'error' 發出。

實施者不應覆蓋此方法，而應實施 writable._destroy() 。