Astro 5.15 | Astro

🎃 Astro 5.15 محافظت خودکار ضد خش Netlify، فیلتر پیش بارگذاری فونت دانه ای و APIهای آداپتور جدید قدرتمند را ارائه می دهد.

بررسی کنید چه چیزی در این نسخه جدید است:

برای ارتقاء یک پروژه موجود، از خودکار استفاده کنید @astrojs/upgrade ابزار CLI. از طرف دیگر، می توانید با اجرای دستور ارتقاء برای مدیر بسته خود، به صورت دستی ارتقا دهید:

pnpm upgrade astro --latest
yarn upgrade astro --latest

Netlify Anti Distortion

Astro 5.15 حفاظت از انحراف خودکار را برای استقرار Netlify معرفی می کند و تضمین می کند که نسخه های کلاینت و سرور سایت شما کاملاً هماهنگ هستند.

انحراف استقرار یک مشکل یواشکی است که زمانی رخ می‌دهد که کاربران دارایی‌های مشتری قدیمی‌تر را در حالی که سرور در حال اجرای کدهای جدیدتر است، بارگذاری می‌کند. این می تواند باعث خطاهای ظریف و رفتار غیرمنتظره ای شود که ردیابی آنها دشوار است. با محافظت ضد اعوجاج Netlify، این موضوع اکنون به گذشته تبدیل شده است.

وقتی در Netlify مستقر می شوید، Astro به طور خودکار شناسه استقرار شما را در تمام درخواست های دارایی و تماس های API درج می کند. این به Netlify اجازه می‌دهد تا به طور خودکار هر گونه اختلاف نسخه را شناسایی و رسیدگی کند – بدون نیاز به پیکربندی. سایت شما فقط کار می کند، حتی در هنگام استقرار سریع یا زمانی که کاربران در اتصالات کندی هستند که می توانند دارایی های خارج از محدودیت های استقرار را بارگیری کنند.

اگر در برنامه خود درخواست های واکشی سفارشی می کنید، می توانید مستقیماً به شناسه استقرار نیز دسترسی داشته باشید:

const deployId = import.meta.env.DEPLOY_ID;
const response = await fetch('/api/endpoint', {

Netlify Anti-Distortion به‌طور یکپارچه در تمام ویژگی‌های اصلی Astro، از جمله View Transitions، Server Islands، Prefetch و Astro Actions کار می‌کند و به شما آرامش خاطر را در کل سایتتان می‌دهد.

APIهای آداپتور جدید برای سفارشی کردن هدرها و دارایی ها

در پشت صحنه، ضد اعوجاج Netlify توسط مجموعه جدیدی از APIهای اصلی که به آداپتورها اجازه می‌دهد هر دو هدر را سفارشی کنند و پارامترهای دارایی‌های موجود در سیستم‌های Astro را درخواست کنند، تامین می‌شود.

Astro اکنون یک را نشان می دهد client گزینه پیکربندی ج AstroAdapter رابطی که به آداپتورها اجازه می دهد تا تعریف کنند:

• internalFetchHeaders – هدرهای سفارشی برای گنجاندن خودکار در تمام تماس‌های واکشی که توسط سیستم‌های هسته Astro انجام می‌شود (عملیات، مشاهده انتقال، جزایر سرور و واکشی اولیه)
• assetQueryParams – پارامترهای پرس و جو به صورت خودکار به URL دارایی ها اضافه می شوند

این به پلتفرم‌های میزبانی قلاب‌هایی را می‌دهد که برای پیاده‌سازی ویژگی‌های پیچیده مانند ضد جعل بدون نیاز به پیکربندی دستی از سوی توسعه‌دهندگان، نیاز دارند.

در اینجا نحوه پیکربندی یک آداپتور این گزینه ها در astro:config:done قلاب:

export default function exampleAdapter() {
      'astro:config:done': async ({ setAdapter }) => {
          serverEntrypoint: 'example-adapter/ssr.js',
            internalFetchHeaders: () => {
              const deployId = process.env.DEPLOY_ID;
                return { 'x-deploy-id': deployId };
            assetQueryParams: process.env.DEPLOY_ID
              ? new URLSearchParams({ deployId: process.env.DEPLOY_ID })

آداپتور Vercel هم اکنون از این API های جدید بهره می برد. پیش از این، ضد اعوجاج Vercel دارای محدودیت‌ها و اشکالاتی بود که مانع از عملکرد صحیح آن در تمام ویژگی‌های Astro می‌شد. با این به‌روزرسانی، آداپتور Vercel اکنون از همان APIهای جدید برای ارائه محافظت مطمئن در برابر اعوجاج استفاده می‌کند VERCEL_SKEW_PROTECTION_ENABLED متغیر محیطی فعال است و آن را به برابری ویژگی با Netlify می رساند.

فیلتر دانه ای فونت از پیش بارگذاری شده

API فونت آزمایشی اکنون از کنترل دقیقی پشتیبانی می کند که انواع فونت ها از قبل بارگذاری شده اند. قبلاً، فقط می‌توانستید تمام تغییرات یک فونت را از قبل بارگیری کنید یا هیچ کدام. اکنون می‌توانید دقیقاً مشخص کنید که کدام وزن‌ها، سبک‌ها و زیرمجموعه‌ها باید از قبل بارگذاری شوند، و به شما کمک می‌کند عملکرد را فقط با دانلود آنچه واقعاً استفاده می‌کنید، بهینه کنید.

هنگام استفاده جزء، شما می توانید ارسال کنید preload آرایه برای فیلتر انواع:

import { Font } from 'astro:assets';
  cssVariable="--font-roboto"
    { subset: 'latin', style: 'normal' },