← Cloudflare Workers / workers / vite-plugin / reference

Static Assets

Tento průvodce se zaměřuje na oblasti práce se statickými assety, které jsou specifické pro plugin Vite. Obecnější dokumentaci najdete v Static Assets.

Plugin Vite nevyžaduje, abyste zadali assets pole, aby se povolily assety, a místo toho určuje, zda se mají assety zahrnout na základě toho, zda client prostředí bylo sestaveno. Ve výchozím nastavení client prostředí se sestaví, pokud je splněna některá z následujících podmínek:

• Existuje index.html soubor v kořenovém adresáři projektu
• build.rollupOptions.input nebo environments.client.build.rollupOptions.input je zadáno ve vaší konfiguraci Vite
• Máte neprázdný public adresář ↗
• Váš Worker importuje prostředky jako URL adresy ↗

Při spuštění vite build, výstup wrangler.json konfigurační soubor se generuje jako součást výstupu sestavení. Soubor assets.directory pole v tomto souboru se automaticky vyplní cestou k vašemu client výstupu buildu. Proto není nutné zadávat assets.directory pole ve vaší vstupní konfiguraci Workeru.

assets konfiguraci je však třeba použít, pokud chcete nastavit konfigurace směrování nebo povolte vazba assets. Následující příklad konfiguruje not_found_handling pro single-page aplikaci tak, aby záložní stránkou byl vždy kořenový index.html .

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

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

Plugin Vite zajišťuje, že všechny Vite zpracování statických aktiv ↗ funkce jsou podporované jak ve vašem Workeru, tak ve frontendu. Patří mezi ně import assetů jako URL, import jako řetězců a import z public adresář a zároveň vkládá aktiva přímo do kódu.

Assets importovány jako URL adresy ↗ lze načíst pomocí vazba assets. Vzhledem k tomu, že vazba fetch metoda vyžaduje úplnou URL adresu, doporučujeme proto použít URL adresu požadavku jako base. Ukazuje to následující příklad:

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

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

Assets importované jako URL adresy ve vašem Workeru se automaticky přesunou do výstupu klientského buildu. Při spuštění vite build se cesty všech přesunutých assets zobrazí v konzoli.

Vlastní hlavičky a přesměrování jsou podporovány při sestavení, náhledu a nasazení, pokud přidáte _headers a _redirects soubory do svého public adresář ↗. Cesty v těchto souborech by měly odpovídat struktuře výstupu sestavení klienta. Vygenerované assety se například obvykle nacházejí ve podadresář assets ↗.