# Odosielajte súbory a streamy klientovi

> Servírujte súbor z disku cez $.file(), vynúťte názov pri sťahovaní, posielajte generovaný obsah cez $.stream() a odpovedzte 404, keď súbor neexistuje.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: sk
Content-SHA256: 00fad9f4bd3b265e966964ed001f988f45538176c0b5d8ee260143bdf4cda557
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`$.file(path, [download])` odošle súbor z disku. Hlavička `content-type` vychádza z prípony. Ako druhý argument odovzdajte `true`, aby prehliadač súbor stiahol pod jeho vlastným názvom, alebo reťazec, ktorým názov zvolíte (`attachment; filename*=...` sa nastaví za vás, bezpečne pre UTF-8). Cesta, ktorá neexistuje, skončí stránkou 404.

`$.stream(type, stream, [download])` odošle ľubovoľný čitateľný stream so zadaným typom obsahu: generovaný súbor, odpoveď iného servera alebo export z databázy. Nenastavuje dĺžku, takže odpoveď sa prenáša po častiach. `PATH.public()`, `PATH.private()` a `PATH.tmp()` vytvárajú absolútne cesty do priečinkov projektu; súbory v `public/` sa už servírujú bez akejkoľvek trasy, preto `$.file()` používajte pre súbory, ktoré majú zostať súkromné alebo potrebujú predchádzajúcu kontrolu.

```js controllers/download.js
const Fs = require('fs');

exports.install = function() {
	ROUTE('GET /report/', report);
	ROUTE('GET /report/save/', report_save);
	ROUTE('GET /export/', export_csv);
	ROUTE('GET /missing/', missing);
};

function filepath() {
	var filename = PATH.tmp('report.txt');
	Fs.writeFileSync(filename, 'Total.js report\n');
	return filename;
}

function report($) {
	$.file(filepath());
}

function report_save($) {
	$.file(filepath(), 'my report.txt');
}

function export_csv($) {
	var stream = Fs.createReadStream(filepath());
	$.stream('text/csv', stream, 'export.csv');
}

function missing($) {
	$.file(PATH.tmp('does-not-exist.txt'));
}
```