← Cloudflare Workers / workers / static-assets / routing / advanced
Zpracování HTML
Vynucení nebo odstranění koncových lomítek v cestách požadavků (například example.com/page/ oproti example.com/page) bývá něco, co chtějí vývojáři z estetických důvodů řídit sami. Kromě toho to může ovlivnit SEO, protože vyhledávače často považují URL s koncovým lomítkem a bez něj za dvě odlišné, samostatné stránky. Tento rozdíl může vést k duplicitnímu obsahu, problémům s indexací a celkové nejistotě ohledně správné kanonické verze stránky.
assets.html_handling konfigurace určuje přesměrování a přepisy požadavků na obsah HTML. Slouží k zadání vzoru kanonických URL, tedy odkud Cloudflare obsah HTML obsluhuje, a zároveň kam přesměrovává nekanonické URL.
Vezměte v úvahu následující strukturu adresářů:
- dist
- file.html
- složka
- index.html
Automatická koncová lomítka (výchozí)
Tímto obvykle automaticky získáte požadované chování: jednotlivé soubory (např. foo.html) se obslouží bez koncové lomítko a indexové soubory složek (např. foo/index.html) se obslouží s koncové lomítko.
{
"name": "my-worker",
// Set this to today's date
"compatibility_date": "2026-08-28",
"assets": {
"directory": "./dist/",
"html_handling": "auto-trailing-slash"
}
}name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
[assets]
directory = "./dist/"
html_handling = "auto-trailing-slash"Na základě příchozích požadavků by byly obsluhovány následující assets:
| Příchozí požadavek | Odpověď | Odeslaný Asset |
|---|---|---|
| /file | 200 | /dist/file.html |
| /file.html | 307 na /file | - |
| /file/ | 307 na /file | - |
| /file/index | 307 na /file | - |
| /file/index.html | 307 na /file | - |
| /folder | 307 na /folder/ | - |
| /folder.html | 307 na /folder | - |
| /folder/ | 200 | /dist/folder/index.html |
| /folder/index | 307 na /folder | - |
| /folder/index.html | 307 na /folder | - |
Vynutit koncová lomítka
Alternativně můžete vynutit koncová lomítka (force-trailing-slash).
{
"name": "my-worker",
// Set this to today's date
"compatibility_date": "2026-08-28",
"assets": {
"directory": "./dist/",
"html_handling": "force-trailing-slash"
}
}name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
[assets]
directory = "./dist/"
html_handling = "force-trailing-slash"Na základě příchozích požadavků by byly obsluhovány následující assets:
| Příchozí požadavek | Odpověď | Odeslaný Asset |
|---|---|---|
| /file | 307 na /file/ | - |
| /file.html | 307 na /file/ | - |
| /file/ | 200 | /dist/file.html |
| /file/index | 307 na /file/ | - |
| /file/index.html | 307 na /file/ | - |
| /folder | 307 na /folder/ | - |
| /folder.html | 307 na /folder/ | - |
| /folder/ | 200 | /dist/folder/index.html |
| /folder/index | 307 na /folder/ | - |
| /folder/index.html | 307 na /folder/ | - |
Odstranit koncová lomítka
Nebo můžete vynechat koncová lomítka (drop-trailing-slash).
{
"name": "my-worker",
// Set this to today's date
"compatibility_date": "2026-08-28",
"assets": {
"directory": "./dist/",
"html_handling": "drop-trailing-slash"
}
}name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
[assets]
directory = "./dist/"
html_handling = "drop-trailing-slash"Na základě příchozích požadavků by byly obsluhovány následující assets:
| Příchozí požadavek | Odpověď | Odeslaný Asset |
|---|---|---|
| /file | 200 | /dist/file.html |
| /file.html | 307 na /file | - |
| /file/ | 307 na /file | - |
| /file/index | 307 na /file | - |
| /file/index.html | 307 na /file | - |
| /folder | 200 | /dist/folder/index.html |
| /folder.html | 307 na /folder | - |
| /folder/ | 307 na /folder | - |
| /folder/index | 307 na /folder | - |
| /folder/index.html | 307 na /folder | - |
Zakázat zpracování HTML
Alternativně, pokud máte specifické požadavky, můžete vestavěné zpracování HTML zcela vypnout (none).
{
"name": "my-worker",
// Set this to today's date
"compatibility_date": "2026-08-28",
"assets": {
"directory": "./dist/",
"html_handling": "none"
}
}name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
[assets]
directory = "./dist/"
html_handling = "none"Na základě příchozích požadavků by byly obsluhovány následující assets:
| Příchozí požadavek | Odpověď | Odeslaný Asset |
|---|---|---|
| /file | Závisí na not_found_handling |
Závisí na not_found_handling |
| /file.html | 200 | /dist/file.html |
| /file/ | Závisí na not_found_handling |
Závisí na not_found_handling |
| /file/index | Závisí na not_found_handling |
Závisí na not_found_handling |
| /file/index.html | Závisí na not_found_handling |
Závisí na not_found_handling |
| /folder | Závisí na not_found_handling |
Závisí na not_found_handling |
| /folder.html | Závisí na not_found_handling |
Závisí na not_found_handling |
| /folder/ | Závisí na not_found_handling |
Závisí na not_found_handling |
| /folder/index | Závisí na not_found_handling |
Závisí na not_found_handling |
| /folder/index.html | 200 | /dist/folder/index.html |