# Ograniczanie trasy flagami

> Dodaj @flagi, takie jak @json, @xml lub @upload, aby trasa pasowała tylko do żądań, dla których jest przeznaczona.

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

Flagi zaczynają się od `@` i stoją po URL. Trasa pasuje tylko wtedy, gdy żądanie spełnia wszystkie jej flagi; w przeciwnym razie Total.js próbuje następnej trasy dla tego samego URL i odpowiada 404, gdy żadna nie pasuje. Przydatne flagi:

- `@json` i `@xml`: body musi być JSON lub XML
- `@xhr`: żądanie musi być żądaniem AJAX (nagłówek `x-requested-with`)
- `@upload`: body musi być `multipart/form-data`
- `@debug` i `@release`: trasa istnieje tylko w tym trybie
- `@mobile` i `@robot`: klient to przeglądarka mobilna lub robot indeksujący

```js controllers/data.js
exports.install = function() {
	ROUTE('POST /data/ @json', json_only);
	ROUTE('POST /data/ @xml', xml_only);

	// Careful: a route with flags has a lower priority than the same URL without flags
	ROUTE('POST /mixed/ @json', json_only);
	ROUTE('POST /mixed/', anything);
};

function json_only($) {
	$.json({ handler: 'json' });
}

function xml_only($) {
	$.json({ handler: 'xml' });
}

function anything($) {
	$.json({ handler: 'anything' });
}
```

Nigdy nie mieszaj trasy z flagami i trasy bez flag pod tym samym URL: ta bez flag jest sprawdzana pierwsza i przejmuje wszystkie żądania, więc trasa z flagami nigdy nie zostaje osiągnięta.