# Receber carregamentos de ficheiros

> Aceite multipart/form-data com o flag @upload e leia os ficheiros carregados de $.files.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: pt
Content-SHA256: 94331498d9b35c1c854f303bd5d5286bc75216ee1fe406535ba5d3fe7b5486c8
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Marque a rota com `@upload` para que só aceite `multipart/form-data` e defina um limite de tamanho adequado aos ficheiros esperados (aqui `<5mb`). Os ficheiros carregados estão em `$.files`; os restantes campos do formulário estão em `$.body`. Cada ficheiro tem `name`, `filename`, `size` e `type`, e métodos como `read()`, `copy()` e `move()`.

```js controllers/upload.js
exports.install = function() {
	ROUTE('POST /upload/ @upload <5mb', upload);
};

function upload($) {

	var file = $.files[0];

	if (!file) {
		$.invalid('No file');
		return;
	}

	file.read(function(err, buffer) {
		$.json({
			filename: file.filename,
			size: file.size,
			type: file.type,
			text: buffer.toString('utf8'),
			title: $.body.title
		});
	});
}
```