Astro v4.10リリース!型安全な環境変数を実験的にサポート

オープンソースの静的サイトジェネレーター「Astro」のバージョン4.10がリリースされました。このリリースでは、新しい型安全な環境変数のサポートや、コンテナーAPIの強化、全HTTPメソッドに対応したリライト機能など、多くの新機能が追加されています。
この記事では、Astro 4.10のアップデート内容について詳しく解説します。
Astro 4.10の主な更新内容
実験的なastro:envモジュール
Astro 4.10では、新しい実験的なモジュールとしてastro:envが導入されました。このモジュールを使用すると、環境変数を型安全に扱うことができます。
環境変数を使うと、アプリケーションを異なる環境で異なる設定で動作させることができます。しかし、これは多くの複雑さを伴います。たとえば、クライアントとサーバーの両方で必要な変数があり、サーバー側の変数は機密情報であることが多いです。これらを効率的に管理するために、astro:envが開発されました。
以下は、astro:envの使い方の例です。
import { defineConfig, envField } from "astro/config";
export default defineConfig({ experimental: { env: { schema: { API_PORT: envField.number({ context: "server", access: "secret", default: 7000 }), PUBLIC_DASHBOARD_V2: envField.boolean({ context: "server", access: "public", default: false }), } } }})定義した変数は、astro:env/serverやastro:env/clientモジュールから取得できます。
import { PUBLIC_DASHBOARD_V2, getSecret } from "astro:env/server";
if (PUBLIC_DASHBOARD_V2) { const API_PORT = getSecret("API_PORT") // number await fetch(`https://my-secret-api.com:${API_PORT}/v2`)}スキーマで定義されていない変数は、getSecret()で取得できます。これは、CloudflareやNode.js、Denoのいずれの環境でも動作します。
全HTTPメソッドでのリライト
バージョン4.9で導入されたリライト機能は、GETリクエストに限定されていましたが、Astro 4.10では、すべてのHTTPメソッドに対してリライトをサポートするようになりました。
これにより、異なるメソッドのリクエストを他のエンドポイントにルーティングできます。リライトは、新しいリクエストを作成し、既存のヘッダーやボディを新しいリクエストにコピーすることで実現されます。
たとえば、APIへのアクセスをデフォルトバージョンのAPIエンドポイントにリライトする場合、次のように記述できます。
import { defineMiddleware } from "astro:middleware";
export const onRequest = defineMiddleware(({ request, url }, next) => { if(request.method === "POST" && url.pathname === "/api") { return next("/api/v2"); }});Astroの埋め込み
Astro 4.10では、コンテナーAPIを使用してAstroコンポーネントを他のフレームワークや環境に埋め込むことができるようになりました。これにより、Astroコンポーネントをより多くの場面で利用することが可能になります。
公式ブログでは、PHPアプリケーション内でAstroコンポーネントを使用するデモが示されています。
import * as components from "./dist/server/all.mjs";import { renderers } from "./dist/server/renderers.mjs";import { manifest } from "./dist/server/entry.mjs";import { experimental_AstroContainer as AstroContainer } from "astro/container";
const container = await AstroContainer.create({ manifest, renderers, resolve(s) { const found = manifest.entryModules[s]; if(found) { return `/astro-project/dist/client/${found}`; } return found; }});
const html = await container.renderToString(components.ReactWrapper);
// Log to the console so that PHP injects the HTML into its page.console.log(html);コンテナーAPIのヘルパー
また、コンテナーAPIをVite環境でより簡単に利用するためのヘルパー関数も追加されました。getContainerRenderer()を使用すると、各パッケージのクライアントおよびサーバーレンダリングスクリプトを手動で設定する必要がなくなります。
import { experimental_AstroContainer as AstroContainer } from "astro/container";import ReactWrapper from "../src/components/ReactWrapper.astro";import { loadRenderers } from "astro:container";import { getContainerRenderer } from "@astrojs/react";
test("ReactWrapper with react renderer", async () => { const renderers = await loadRenderers([getContainerRenderer()]) const renderers = [ { name: "@astrojs/react", clientEntrypoint: "@astrojs/react/client.js", serverEntrypoint: "@astrojs/react/server.js", }, ]; const container = await AstroContainer.create({ renderers, }); const result = await container.renderToString(ReactWrapper);
expect(result).toContain("Counter"); expect(result).toContain("Count: <!-- -->5");});Astro 4.10へのアップデート方法
既存のプロジェクトをAstro v4.10にアップデートするには、@astrojs/upgradeを使用できます。または、パッケージマネージャーのアップグレードコマンドを実行して手動でアップグレードできます。
npx @astrojs/upgradenpm install astro@latestpnpm upgrade astro --latestyarn upgrade astro --latestまとめ
Astro 4.10は、新しい型安全な環境変数のサポートや全HTTPメソッドでのリライト機能、コンテナーAPIの強化など、多くの新機能を含むリリースです。これにより、より柔軟で効率的な開発が可能となります。興味がある方はぜひ新しいバージョンを試してみてください。
また、Astro 4.10の詳細について紹介した動画も公開されているので、合わせてチェックしてみてください。
参考
記事をシェア
フォローして最新情報を入手
Googleの優先ソースに追加すると、このサイトの記事をGoogleで見つけやすくなります。また、ぜひXやRSSフィードもフォローしてください。
次の記事
-1.png&w=1080&q=75)
生まれた時から、母国語よりも先にJavaScriptを使っていました。ネットの海のどこにもいなくてどこにでもいます。
Webフロントエンドプログラマーとして、TypeScriptを用いたWebアプリやブラウザー拡張機能を制作。Xのシャドウバン検知ツール「Shadowban Scanner」やリンクカード復活ツール「Restore Link Card」を公開し、国内外のメディアで紹介されました。iGEM 2023ではJapan-UnitedチームのWikiを制作してGrand Prizeの獲得に貢献。ブログではXやSNSの最新ニュース、不具合の検証と対処法、フロントエンド開発の知見を発信しています。






![[新しいXチャットへようこそ]というテキストが画面に大きく表示されており、その下には次の3つの説明が表示されている。[エンドツーエンドの暗号化:メッセージは、端末にかかわらずエンドツーエンドで暗号化されています。][最先端のプライバシー:Xを含め、他の人がメッセージを読むことはできません。][パスコードを設定:メッセージを保護するため、4桁のパスコードを設定してください。]これらの説明の下には、[パスコードを作成]という大きなボタンが配置されている](/_next/image/?url=%2Fapi%2Fmedia%2Ffile%2Fwelcome-to-new-chat.png&w=1920&q=75)


![Gboardの[フリック入力のみ]の設定画面の開き方を示したスクリーンショット](/_next/image/?url=%2Fapi%2Fmedia%2Ffile%2Fgboard-flick-only.png&w=3840&q=75)

