Eliberează un stream când se termină cu CLEANUP()
CLEANUP(stream, [callback]) așteaptă ca un stream să se termine (s-a încheiat, a fost închis sau a eșuat) și apoi îl distruge, ceea ce eliberează handle-ul de fișier sau socketul din spatele lui. Cu un callback, acesta este apelat după aceea; fără el, funcția returnează o promisiune care se rezolvă în acel moment. Este apelul pe care îl faci după ce ai dat un stream unui element care îl citește (un răspuns, un pipe, o încărcare) atunci când vrei să fii sigur că nimic nu rămâne deschis dacă cealaltă parte se oprește mai devreme.
const Fs = require('fs');
const { PassThrough } = require('stream');
exports.install = function() {
ROUTE('GET /copy/', copy);
ROUTE('GET /copy-callback/', copycallback);
};
async function copy($) {
const file = PATH.tmp('cleanup.txt');
Fs.writeFileSync(file, 'some text to read');
const stream = Fs.createReadStream(file);
const chunks = [];
// a sink that reads everything
const sink = new PassThrough();
sink.on('data', chunk => chunks.push(chunk));
stream.pipe(sink);
const before = stream.destroyed;
await CLEANUP(stream);
$.json({ before: before, after: stream.destroyed, content: Buffer.concat(chunks).toString() });
}
function copycallback($) {
const file = PATH.tmp('cleanup.txt');
Fs.writeFileSync(file, 'again');
const stream = Fs.createReadStream(file);
stream.resume();
CLEANUP(stream, () => $.json({ destroyed: stream.destroyed }));
}