Astro 4.6 发布,支持手动设置国际化路由策略

经过发行周的短暂休息,Astro 4.6 现已推出,我们又回到了正常的时间表!此版本包括一个新的手动路由策略用于国际化,对 CSRF 保护进行了实验性支持,开发工具栏新增功能等。

Astro 4.6 发布,支持手动设置国际化路由策略

完整的发布亮点包括:

  • 手动 i18n 路由策略
  • 移动开发工具栏
  • 实验性:支持 CSRF 保护
  • Cookie 改进
  • 不再支持旧版本 Node.js

要升级现有项目,请使用自动化 @astrojs/upgrade CLI 工具。或者通过运行包管理器的升级命令来手动升级:

# 推荐
npx @astrojs/upgrade

# 手动
npm install astro@latest
pnpm upgrade astro --latest
yarn upgrade astro --latest

手动 i18n 路由策略

Astro 4.6 引入了国际化的手动路由策略。在默认路由策略不能完全满足你的需求的情况下,这个新策略允许你完全控制国际化 Astro 网站的路由。

要启用手动路由,请将 astro.config.mjs 中的 i18n.routing 选项设置为 manual

// astro.config.mjs
import { defineConfig } from "astro/config";

export default defineConfig({
  i18n: {
    locales: ["en", "fr"],
    defaultLocale: "fr",
    routing: "manual",
  },
});

然后向你的项目添加一个中间件来处理路由:

// src/middleware.ts
import { defineMiddleware } from "astro:middleware";
import { redirectToDefaultLocale } from "astro:i18n";

// 示例中间件,将所有请求重定向到默认语言环境,除了 /about 页面。
export const onRequest = defineMiddleware(async (context, next) => {
  if (context.url.startsWith("/about")) {
    return next();
  } else {
    return redirectToDefaultLocale(context, 302);
  }
});

或者,你可以使用 astro:i18n 中的新 middleware 函数导入 Astro 自己的中间件逻辑,以构建默认路由策略:

import { defineMiddleware, sequence } from "astro:middleware";
import { middleware } from "astro:i18n"; // Astro 自己的 i18n 路由中间件

export const userMiddleware = defineMiddleware(() => {
  // 在这里写入您的自定义中间件逻辑
});

export const onRequest = sequence(
  userMiddleware,
  middleware({
    redirectToDefaultLocale: false,
    prefixDefaultLocale: true
  })
)

查看国际化文档,了解有关如何使用手动路由进行国际化的更多信息。

移动开发工具栏

Astro 4.6 引入了将开发工具栏移动到屏幕底部不同位置的功能。如果你有一个覆盖屏幕底部的粘性标题,或者你只是希望工具栏位于其他位置,这可能会很有用。开发工具栏可以帮助你,而不是妨碍你!

实验性:支持 CSRF 保护

Astro 4.6 添加了对 CSRF 保护的实验性部分支持。此功能目前处于实验阶段,可能会在未来的版本中发生变化。

要启用它,请在 astro.config.mjs 中设置 experimental.security.csrfProtection 选项:

// astro.config.mjs
import { defineConfig } from "astro/config";

export default defineConfig({
  experimental: {
    security: {
      csrfProtection: {
        origin: true,
      },
    },
  },
});

启用此设置会使 Astro 执行检查,确保所有现代浏览器自动传递的「origin」标头与每个 Request 发送的 URL 相匹配。如果没有,Astro 将使用 403 Forbidden 状态代码进行响应。

请注意,此功能仅适用于按需呈现的页面(也称为服务器端呈现)。

Cookie 改进

Astro 删除 cookie 的助手 Astro.cookies.delete 现在允许设置更多 cookie 属性,而不仅仅是 pathdomain 属性。也许这只是一点点的进步,但绝对是一个你值得体验的改变。

不再支持旧版本 Node.js

根据我们的 Node.js 支持和升级政策,此版本的 Astro 不再支持:

  • Node.js 18 版本低于 18.17.1
  • Node.js 19(奇数版本)
  • Node.js 20 版本低于 20.3.0

正如我们的支持政策中所述,这一决定是在仔细考虑了几个因素后做出的。我们相信这一变化将为所有用户带来更稳定、更安全的 Astro 体验。

你可以继续使用已弃用的 Node.js 版本,直到 Astro 的下一个主要版本 (v5)。但是,安装 Astro 时你可能会看到警告,并且某些功能可能无法按预期工作。

Bug 修复

Astro 4.6 包括更多错误修复和较小的改进,这些改进无法包含在本发布帖子中,查看完整的发行说明以了解更多信息。

原文链接:https://juejin.cn/post/7356625386631315491 作者:一纸忘忧

(0)
上一篇 2024年4月12日 上午10:16
下一篇 2024年4月12日 上午10:26

相关推荐

发表回复

登录后才能评论