← Cloudflare Workers / workers / vite-plugin / reference

Static Assets

В этом руководстве рассматриваются особенности работы со статическими ресурсами, характерные именно для плагина Vite. Общую документацию см. Static Assets.

Плагин Vite не требует указывать assets поле, чтобы включить ресурсы, а вместо этого определяет, следует ли включать ресурсы, на основе того, client окружение было собрано. По умолчанию client окружение собирается, если выполняется любое из следующих условий:

• Существует index.html файл в корне вашего проекта
• build.rollupOptions.input или environments.client.build.rollupOptions.input указан в вашей конфигурации Vite
• У вас есть непустой public каталог ↗
• Ваш Worker импортирует ресурсы как URL ↗

При выполнении vite build, выходной wrangler.json файл конфигурации создаётся как часть результата сборки. assets.directory поле в этом файле автоматически заполняется путём к client результата сборки. Поэтому нет необходимости указывать assets.directory поле во входной конфигурации Worker.

assets конфигурацию, однако если вы хотите задать конфигурация маршрутизации или включите привязка assets. Следующий пример настраивает not_found_handling для одностраничного приложения, чтобы резервным вариантом всегда служил корневой index.html файл.

{
	"assets": {
		"not_found_handling": "single-page-application"
	}
}

[assets]
not_found_handling = "single-page-application"

Плагин Vite гарантирует, что все функции Vite обработка статических ресурсов ↗ функции поддерживаются как в вашем Worker, так и во фронтенде. К ним относятся импорт ресурсов в виде URL, импорт в виде строк и импорт из public каталог, а также встраивает ресурсы.

Ресурсы импортируются как URL ↗ можно получить через привязка assets. Поскольку у привязки fetch метод требует полный URL, поэтому рекомендуем использовать URL запроса в качестве base. Это показано в следующем примере:

import myImage from "./my-image.png";

export default {
	fetch(request, env) {
		return env.ASSETS.fetch(new URL(myImage, request.url));
	},
};

Ресурсы, импортированные как URL в вашем Worker, будут автоматически перемещены в клиентскую сборку. При выполнении vite build пути всех перемещённых ресурсов будут выведены в консоль.

Пользовательский заголовки и перенаправления поддерживаются на этапах сборки, предпросмотра и развёртывания при добавлении _headers и _redirects файлы в свой public каталог ↗. Пути в этих файлах должны соответствовать структуре сборки клиентской части. Например, сгенерированные ресурсы обычно находятся в подкаталог assets ↗.