ろぼいんブログ
更新:

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の使い方の例です。

try{(()=>{function a(e){if(!e)return;let t=e.getAttribute("tabindex")!==null,n=e.scrollWidth>e.clientWidth;n&&!t?e.setAttribute("tabindex","0"):!n&&t&&e.removeAttribute("tabindex")}var u=window.requestIdleCallback||(e=>setTimeout(e,1)),i=window.cancelIdleCallback||clearTimeout;function l(e){let t=new Set,n,r;return new ResizeObserver(c=>{c.forEach(o=>t.add(o.target)),n&&clearTimeout(n),r&&i(r),n=setTimeout(()=>{r&&i(r),r=u(()=>{t.forEach(o=>e(o)),t.clear()})},250)})}function d(e,t){e.querySelectorAll?.(".expressive-code pre > code").forEach(n=>{let r=n.parentElement;r&&t.observe(r)})}var s=l(a);d(document,s);var b=new MutationObserver(e=>e.forEach(t=>t.addedNodes.forEach(n=>{d(n,s)})));b.observe(document.body,{childList:!0,subtree:!0});document.addEventListener("astro:page-load",()=>{d(document,s)});})();}catch(e){console.error("[EC] tabindex-js-module failed:",e)}try{(()=>{function i(o){let e=document.createElement("pre");Object.assign(e.style,{opacity:"0",pointerEvents:"none",position:"absolute",overflow:"hidden",left:"0",top:"0",width:"20px",height:"20px",webkitUserSelect:"auto",userSelect:"all"}),e.ariaHidden="true",e.textContent=o,document.body.appendChild(e);let a=document.createRange();a.selectNode(e);let n=getSelection();if(!n)return!1;n.removeAllRanges(),n.addRange(a);let r=!1;try{r=document.execCommand("copy")}finally{n.removeAllRanges(),document.body.removeChild(e)}return r}async function l(o){let e=o.currentTarget,a=e.dataset,n=!1,r=a.code.replace(/\u007f/g,` `);try{await navigator.clipboard.writeText(r),n=!0}catch{n=i(r)}if(!n||e.parentNode?.querySelector(".feedback"))return;let t=document.createElement("div");t.classList.add("feedback"),t.append(a.copied),e.before(t),t.offsetWidth,requestAnimationFrame(()=>t?.classList.add("show"));let c=()=>!t||t.classList.remove("show"),d=()=>{!t||parseFloat(getComputedStyle(t).opacity)>0||(t.remove(),t=void 0)};setTimeout(c,1500),setTimeout(d,2500),e.addEventListener("blur",c),t.addEventListener("transitioncancel",d),t.addEventListener("transitionend",d)}function s(o){o.querySelectorAll?.(".expressive-code .copy button").forEach(e=>e.addEventListener("click",l))}s(document);var u=new MutationObserver(o=>o.forEach(e=>e.addedNodes.forEach(a=>{s(a)})));u.observe(document.body,{childList:!0,subtree:!0});document.addEventListener("astro:page-load",()=>{s(document)});})();}catch(e){console.error("[EC] copy-js-module failed:",e)}
astro.config.ts
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/serverastro: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を使用できます。または、パッケージマネージャーのアップグレードコマンドを実行して手動でアップグレードできます。

Terminal window
npx @astrojs/upgrade
Terminal window
npm install astro@latest
pnpm upgrade astro --latest
yarn upgrade astro --latest

まとめ

Astro 4.10は、新しい型安全な環境変数のサポートや全HTTPメソッドでのリライト機能、コンテナーAPIの強化など、多くの新機能を含むリリースです。これにより、より柔軟で効率的な開発が可能となります。興味がある方はぜひ新しいバージョンを試してみてください。

また、Astro 4.10の詳細について紹介した動画も公開されているので、合わせてチェックしてみてください。

参考

おすすめアイテム

※このリンクを経由して商品を購入すると、当サイトの運営者が報酬を得ることがあります。詳細はこちら

このサイトを支援する

Buy Me a CoffeeまたはGitHub Sponsorsで支援していただけると、サイトの運営やコンテンツ制作の励みになります。定期的な支援と一度限りの支援がありますので、お間違いのないようにお願いします。

Buy me a coffee

著者のアイコン画像

生まれた時から、母国語よりも先にJavaScriptを使っていました。ネットの海のどこにもいなくてどこにでもいます。

Webフロントエンドプログラマーで、テクノロジーに関する話題を追いかけています。動画編集やプログラミングが趣味で、たまにデザインなどもやっています。主にTypeScriptを使用したWebフロントエンド開発を専門とし、便利で実用的なブラウザー拡張機能を作成しています。また、個人ブログを通じて、IT関連のニュースやハウツー、技術的なプログラミング情報を発信しています。

最新記事