# Rilascia uno stream quando finisce con CLEANUP()

> Usa CLEANUP() per distruggere uno stream appena è terminato o ha fallito, in modo che non restino aperti descrittori di file, con un callback o come promise.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: it
Content-SHA256: 68eb085482e970da461dc9850456ba7024a92ffd83e6b101de4a1903c93baa02
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`CLEANUP(stream, [callback])` aspetta che uno stream sia **finito** (è terminato, è stato chiuso o ha fallito) e poi lo distrugge, liberando il descrittore di file o il socket che c'è dietro. Con un callback, questo viene chiamato dopo; senza, restituisce una promise che si risolve in quel momento. È la chiamata da fare dopo aver consegnato uno stream a qualcosa che lo legge (una risposta, un pipe, un upload) quando vuoi essere sicuro che nulla resti aperto se l'altra parte si ferma in anticipo.

```js controllers/streams.js
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 }));
}
```
