INTEGRITY Dokumentace

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ářů:

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