Zum Inhalt springen
verdict:

Astro 6.0.0-beta.18

preview

Release Notes

note: die Zusammenfassung und die Release Notes sind auf Englisch

note: keine Zusammenfassung für dieses ältere Release

Wir fassen die neueren Releases zusammen. Die originalen Release Notes dieser Version stehen hier unten.

release-notesgithub.com/withastro/astro · 210 Zeilen
  1. ### Major Changes
  3. - [#15668](https://github.com/withastro/astro/pull/15668) [`1118ac4`](https://github.com/withastro/astro/commit/1118ac4f299341e15061e8a4e6e8423071c4d41c) Thanks [@florian-lefebvre](https://github.com/florian-lefebvre)! - Changes TypeScript configuration - ([v6 upgrade guidance](https://v6.docs.astro.build/en/guides/upgrade-to/v6/#changed-typescript-configuration))
  5. - [#15726](https://github.com/withastro/astro/pull/15726) [`6f19ecc`](https://github.com/withastro/astro/commit/6f19ecc35adfb2ddaabbba2269630f95c13f5a57) Thanks [@ocavue](https://github.com/ocavue)! - Updates dependency `shiki` to v4
  7. Check [Shiki's upgrade guide](https://shiki.style/blog/v4).
  9. ### Minor Changes
  11. - [#15694](https://github.com/withastro/astro/pull/15694) [`66449c9`](https://github.com/withastro/astro/commit/66449c930e73e9a58ce547b9c32635a98a310966) Thanks [@matthewp](https://github.com/matthewp)! - Adds `preserveBuildClientDir` option to adapter features
  13. Adapters can now opt in to preserving the client/server directory structure for static builds by setting `preserveBuildClientDir: true` in their adapter features. When enabled, static builds will output files to `build.client` instead of directly to `outDir`.
  15. This is useful for adapters that require a consistent directory structure regardless of the build output type, such as deploying to platforms with specific file organization requirements.
  17. ```js
  18. // my-adapter/index.js
  19. export default function myAdapter() {
  20. return {
  21. name: 'my-adapter',
  22. hooks: {
  23. 'astro:config:done': ({ setAdapter }) => {
  24. setAdapter({
  25. name: 'my-adapter',
  26. adapterFeatures: {
  27. buildOutput: 'static',
  28. preserveBuildClientDir: true,
  29. },
  30. });
  31. },
  32. },
  33. };
  34. }
  35. ```
  37. - [#15579](https://github.com/withastro/astro/pull/15579) [`08437d5`](https://github.com/withastro/astro/commit/08437d531e31b79a42333a9f7aabaa9fe646ce4f) Thanks [@ascorbic](https://github.com/ascorbic)! - Adds two new experimental flags for a Route Caching API and further configuration-level Route Rules for controlling SSR response caching.
  39. Route caching gives you a platform-agnostic way to cache server-rendered responses, based on web standard cache headers. You set caching directives in your routes using `Astro.cache` (in `.astro` pages) or `context.cache` (in API routes and middleware), and Astro translates them into the appropriate headers or runtime behavior depending on your adapter. You can also define cache rules for routes declaratively in your config using `experimental.routeRules`, without modifying route code.
  41. This feature requires on-demand rendering. Prerendered pages are already static and do not use route caching.
  43. #### Getting started
  45. Enable the feature by configuring `experimental.cache` with a cache provider in your Astro config:
  47. ```js
  48. // astro.config.mjs
  49. import { defineConfig } from 'astro/config';
  50. import node from '@astrojs/node';
  51. import { memoryCache } from 'astro/config';
  53. export default defineConfig({
  54. adapter: node({ mode: 'standalone' }),
  55. experimental: {
  56. cache: {
  57. provider: memoryCache(),
  58. },
  59. },
  60. });
  61. ```
  63. #### Using `Astro.cache` and `context.cache`
  65. In `.astro` pages, use `Astro.cache.set()` to control caching:
  67. ```astro
  68. ---
  69. // src/pages/index.astro
  70. Astro.cache.set({
  71. maxAge: 120, // Cache for 2 minutes
  72. swr: 60, // Serve stale for 1 minute while revalidating
  73. tags: ['home'], // Tag for targeted invalidation
  74. });
  75. ---
  77. <html><body>Cached page</body></html>
  78. ```
  80. In API routes and middleware, use `context.cache`:
  82. ```ts
  83. // src/pages/api/data.ts
  84. export function GET(context) {
  85. context.cache.set({
  86. maxAge: 300,
  87. tags: ['api', 'data'],
  88. });
  89. return Response.json({ ok: true });
  90. }
  91. ```
  93. #### Cache options
  95. `cache.set()` accepts the following options:
  97. - **`maxAge`** (number): Time in seconds the response is considered fresh.
  98. - **`swr`** (number): Stale-while-revalidate window in seconds. During this window, stale content is served while a fresh response is generated in the background.
  99. - **`tags`** (string\[]): Cache tags for targeted invalidation. Tags accumulate across multiple `set()` calls within a request.
  100. - **`lastModified`** (Date): When multiple `set()` calls provide `lastModified`, the most recent date wins.
  101. - **`etag`** (string): Entity tag for conditional requests.
  103. Call `cache.set(false)` to explicitly opt out of caching for a request.
  105. Multiple calls to `cache.set()` within a single request are merged: scalar values use last-write-wins, `lastModified` uses most-recent-wins, and tags accumulate.
  107. #### Invalidation
  109. Purge cached entries by tag or path using `cache.invalidate()`:
  111. ```ts
  112. // Invalidate all entries tagged 'data'
  113. await context.cache.invalidate({ tags: ['data'] });
  115. // Invalidate a specific path
  116. await context.cache.invalidate({ path: '/api/data' });
  117. ```
  119. #### Config-level route rules
  121. Use `experimental.routeRules` to set default cache options for routes without modifying route code. Supports Nitro-style shortcuts for ergonomic configuration:
  123. ```js
  124. import { memoryCache } from 'astro/config';
  126. export default defineConfig({
  127. experimental: {
  128. cache: {
  129. provider: memoryCache(),
  130. },
  131. routeRules: {
  132. // Shortcut form (Nitro-style)
  133. '/api/*': { swr: 600 },
  135. // Full form with nested cache
  136. '/products/*': { cache: { maxAge: 3600, tags: ['products'] } },
  137. },
  138. },
  139. });
  140. ```
  142. Route patterns support static paths, dynamic parameters (`[slug]`), and rest parameters (`[...path]`). Per-route `cache.set()` calls merge with (and can override) the config-level defaults.
  144. You can also read the current cache state via `cache.options`:
  146. ```ts
  147. const { maxAge, swr, tags } = context.cache.options;
  148. ```
  150. #### Cache providers
  152. Cache behavior is determined by the configured **cache provider**. There are two types:
  154. - **CDN providers** set response headers (e.g. `CDN-Cache-Control`, `Cache-Tag`) and let the CDN handle caching. Astro strips these headers before sending the response to the client.
  155. - **Runtime providers** implement `onRequest()` to intercept and cache responses in-process, adding an `X-Astro-Cache` header (HIT/MISS/STALE) for observability.
  157. #### Built-in memory cache provider
  159. Astro includes a built-in, in-memory LRU runtime cache provider. Import `memoryCache` from `astro/config` to configure it.
  161. Features:
  163. - In-memory LRU cache with configurable max entries (default: 1000)
  164. - Stale-while-revalidate support
  165. - Tag-based and path-based invalidation
  166. - `X-Astro-Cache` response header: `HIT`, `MISS`, or `STALE`
  167. - Query parameter sorting for better hit rates (`?b=2&a=1` and `?a=1&b=2` hit the same entry)
  168. - Common tracking parameters (`utm_*`, `fbclid`, `gclid`, etc.) excluded from cache keys by default
  169. - `Vary` header support — responses that set `Vary` automatically get separate cache entries per variant
  170. - Configurable query parameter filtering via `query.exclude` (glob patterns) and `query.include` (allowlist)
  172. For more information on enabling and using this feature in your project, see the [Experimental Route Caching docs](https://docs.astro.build/en/reference/experimental-flags/route-caching/).
  173. For a complete overview and to give feedback on this experimental API, see the [Route Caching RFC](https://github.com/withastro/roadmap/pull/1245).
  175. ### Patch Changes
  177. - [#15721](https://github.com/withastro/astro/pull/15721) [`e6e146c`](https://github.com/withastro/astro/commit/e6e146cb0ac535e21c26f6b1c3d2f65be9dbdb4c) Thanks [@matthewp](https://github.com/matthewp)! - Fixes action route handling to return 404 for requests to prototype method names like `constructor` or `toString` used as action paths
  179. - [#15704](https://github.com/withastro/astro/pull/15704) [`862d77b`](https://github.com/withastro/astro/commit/862d77bd6c3e05e20fd58293f9577ae685a9b8c9) Thanks [@umutkeltek](https://github.com/umutkeltek)! - Fixes i18n fallback middleware intercepting non-404 responses
  181. The fallback middleware was triggering for all responses with status >= 300, including legitimate 3xx redirects, 403 forbidden, and 5xx server errors. This broke auth flows and form submissions on localized server routes. The fallback now correctly only triggers for 404 (page not found) responses.
  183. - [#15703](https://github.com/withastro/astro/pull/15703) [`829182b`](https://github.com/withastro/astro/commit/829182bbdfc307a005aea00ac8c00923f76efb08) Thanks [@matthewp](https://github.com/matthewp)! - Fixes server islands returning a 500 error in dev mode for adapters that do not set `adapterFeatures.buildOutput` (e.g. `@astrojs/netlify`)
  185. - [#15749](https://github.com/withastro/astro/pull/15749) [`573d188`](https://github.com/withastro/astro/commit/573d188de9a7e6635f24004291c3e71e0ddc7a7a) Thanks [@ascorbic](https://github.com/ascorbic)! - Fixes a bug that caused `session.regenerate()` to silently lose session data
  187. Previously, regenerated session data was not saved under the new session ID unless `set()` was also called.
  189. - [#15685](https://github.com/withastro/astro/pull/15685) [`1a323e5`](https://github.com/withastro/astro/commit/1a323e5c64c7c23212ed80546f593d930115d55c) Thanks [@jcayzac](https://github.com/jcayzac)! - Fix regression where SVG images in content collection `image()` fields could not be rendered as inline components. This behavior is now restored while preserving the TLA deadlock fix.
  191. - [#15740](https://github.com/withastro/astro/pull/15740) [`c5016fc`](https://github.com/withastro/astro/commit/c5016fc86c4928a26b49dbe144b5569d5d89ac04) Thanks [@matthewp](https://github.com/matthewp)! - Removes an escape hatch that skipped attribute escaping for URL values containing `&`, ensuring all dynamic attribute values are consistently escaped
  193. - [#15744](https://github.com/withastro/astro/pull/15744) [`fabb710`](https://github.com/withastro/astro/commit/fabb710c2514c5a1298e002dd961a1d79686f021) Thanks [@matthewp](https://github.com/matthewp)! - Fixes cookie handling during error page rendering to ensure cookies set by middleware are consistently included in the response
  195. - [#15742](https://github.com/withastro/astro/pull/15742) [`9d9699c`](https://github.com/withastro/astro/commit/9d9699c04aba7524bd3c8e1b8303691db19fa5bd) Thanks [@matthewp](https://github.com/matthewp)! - Hardens `clientAddress` resolution to respect `security.allowedDomains` for `X-Forwarded-For`, consistent with the existing handling of `X-Forwarded-Host`, `X-Forwarded-Proto`, and `X-Forwarded-Port`. The `X-Forwarded-For` header is now only used to determine `Astro.clientAddress` when the request's host has been validated against an `allowedDomains` entry. Without a matching domain, `clientAddress` falls back to the socket's remote address.
  197. - [#15696](https://github.com/withastro/astro/pull/15696) [`a9fd221`](https://github.com/withastro/astro/commit/a9fd221bda99db4660c241c494b6d3225eb4e51d) Thanks [@Princesseuh](https://github.com/Princesseuh)! - Fixes images not working in MDX when using the Cloudflare adapter in certain cases
  199. - [#15693](https://github.com/withastro/astro/pull/15693) [`4db2089`](https://github.com/withastro/astro/commit/4db2089a8e01cdb298c49f61817daf240ae07fa5) Thanks [@ArmandPhilippot](https://github.com/ArmandPhilippot)! - Fixes the links to Astro Docs to match the v6 structure.
  201. - [#15717](https://github.com/withastro/astro/pull/15717) [`4000aaa`](https://github.com/withastro/astro/commit/4000aaa2d361cbfc9bbf280a9b0e78e6db167945) Thanks [@matthewp](https://github.com/matthewp)! - Ensures that URLs with multiple leading slashes (e.g. `//admin`) are normalized to a single slash before reaching middleware, so that pathname checks like `context.url.pathname.startsWith('/admin')` work consistently regardless of the request URL format
  203. - [#15752](https://github.com/withastro/astro/pull/15752) [`918d394`](https://github.com/withastro/astro/commit/918d3949f3b92b1ae46dadd77cfb1404869c50bd) Thanks [@ascorbic](https://github.com/ascorbic)! - Fixes an issue where a session ID from a cookie with no matching server-side data was accepted as-is. The session now generates a new ID when the cookie value has no corresponding storage entry.
  205. - [#15743](https://github.com/withastro/astro/pull/15743) [`3b4252a`](https://github.com/withastro/astro/commit/3b4252a82a937fccbfd433d90a93ad524a7a6f7b) Thanks [@matthewp](https://github.com/matthewp)! - Hardens config-based redirects with catch-all parameters to prevent producing protocol-relative URLs (e.g. `//example.com`) in the `Location` header
  207. - [#15718](https://github.com/withastro/astro/pull/15718) [`14f37b8`](https://github.com/withastro/astro/commit/14f37b80aa2bd086cf31feccd5016c73a09822ae) Thanks [@florian-lefebvre](https://github.com/florian-lefebvre)! - Fixes a case where internal headers may leak when rendering error pages
  209. - Updated dependencies \[[`6f19ecc`](https://github.com/withastro/astro/commit/6f19ecc35adfb2ddaabbba2269630f95c13f5a57), [`f94d3c5`](https://github.com/withastro/astro/commit/f94d3c5313e5a7576cf2cb316a85d68d335a188f)]:
  210. - @astrojs/markdown-remark@7.0.0-beta.9

auf github ansehenimported 2026-09-28 über npm