Astro v13.5.4 リリースノート解説 | つみかさね

対応ガイド

low|任意バグ修正影響: 最小限

推奨アクション

1テスト環境でアップデートを検証
2dev-modeでの動作確認
3本番環境に適用

影響対象

Astro + Cloudflareアダプター利用者

補足

-このリリースは@astrojs/cloudflareアダプター専用です
-astro本体は別パッケージ（最新: 6.3.7）です

この変更が意味すること

@astrojs/cloudflare v13.5.4は、Cloudflareアダプターを使ったAstroプロジェクトのパッチリリースです（リリースノート内の分類は "Patch Changes"）。

Vite 6からクライアント専用となったvite.optimizeDeps設定が、AstroのSSR・prerenderビルド環境へ正しく転送されない問題が修正されました。具体的には、vite.optimizeDeps.exclude・include・esbuildOptions.loaderといったユーザー設定が、サーバー環境のconfigEnvironmentフックで転送されないために無視されていました。

影響を受けるのは、.dataファイルなど非標準の拡張子を持つパッケージをdev-modeで利用していたプロジェクトです。このような構成では「No loader is configured for '.data' files」といったエラーが発生していました。

主な変更点

SSR/prerender環境への`optimizeDeps`設定転送

以下のvite.optimizeDeps設定がSSR・prerender環境にも適用されるようになりました：

optimizeDeps.exclude
optimizeDeps.include
esbuildOptions.loader

修正前の挙動: vite.optimizeDepsの設定はVite 6でクライアント専用となったため、アダプターのconfigEnvironmentフックで転送されず、サーバー環境では無視されていた。

修正後の挙動: ユーザーが指定したoptimizeDeps設定がSSR/prerenderの各環境にも転送される。

EOL / サポート状況

Astroはendoflife.dateの追跡対象外です。現在のnpm latestはastro@6.3.7で、@astrojs/cloudflareは13.5.4がlatest。

開発者への影響

Cloudflareアダプターを使用し、非標準ファイルタイプ（.data等）を扱うプロジェクト: 本修正の直接の対象です。dev-modeでのエラーが解消されます。
Cloudflareアダプターを使用しているが標準ファイルのみのプロジェクト: 影響を受けることなく、念のためアップデートを推奨します。
他のAstroアダプター（Vercel、Netlify等）使用プロジェクト: このリリースの影響を受けません。

アップデート方法

npm install @astrojs/cloudflare@13.5.4

# または yarn
yarn add @astrojs/cloudflare@13.5.4

# pnpm
pnpm add @astrojs/cloudflare@13.5.4

データソース: GitHub Releases API, npm Registry
AI解説は Claude API により自動生成されています。正確性については原文をご確認ください。

アップデート判断

★★★★★

必要な場合にアップデート

アップデートすべき場合

●Cloudflareアダプターを使用している
●dev-modeでoptimizeDeps関連のエラーが発生していた
●非標準ファイルタイプ（.dataなど）を使用している

様子見でよい場合

●該当するエラーが発生していない
●Cloudflare以外のアダプターを使用している

Astro v13.5.4