← Cloudflare Workers / workers / static-assets / routing / advanced

Обработка HTML

Принудительное добавление или удаление слеша в конце путей запроса (например, example.com/page/ и example.com/page) часто хочется контролировать по эстетическим причинам. Кроме того, это может влиять на SEO, поскольку поисковые системы часто считают URL с завершающей косой чертой и без неё разными, отдельными страницами. Это может приводить к проблемам с дублированным контентом, сложностям с индексацией и общей путанице в вопросе, какая версия страницы является канонической.

assets.html_handling конфигурация определяет перенаправления и переписывание запросов для HTML-контента. Он задает шаблон канонических URL: откуда Cloudflare обслуживает HTML-контент и куда перенаправляет неканонические URL.

Рассмотрим следующую структуру каталогов:

Обычно это автоматически дает нужное поведение: отдельные файлы (например, foo.html) будет отдан без конечный слеш и файлы индекса папки (например, foo/index.html) будет отдан с конечный слеш.

{
	"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"

В зависимости от входящих запросов будут обслуживаться следующие ресурсы:

Также вы можете принудительно добавлять завершающий слэш (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"

В зависимости от входящих запросов будут обслуживаться следующие ресурсы:

Или можно убрать завершающие слеши (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"

В зависимости от входящих запросов будут обслуживаться следующие ресурсы:

Если у вас особые требования, встроенную обработку HTML можно отключить полностью (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"

В зависимости от входящих запросов будут обслуживаться следующие ресурсы: