ابزارهای توسعه•

انتشار Bun نسخه 1.1.26: بررسی عمیق معماری و تأثیر بر اکوسیستم

نسخه 1.1.26 بان (Bun) را با قابلیت‌های idleTimeout، subscriberCount، مدیریت وابستگی‌ها از طریق bun outdated و اصلاحات حیاتی سازگاری با Node.js کاوش کنید.

OP
OPA Release DeskWIRE
•5 min read
انتشار Bun نسخه 1.1.26: بررسی عمیق معماری و تأثیر بر اکوسیستم

⚠️ Breaking Changes & Migration Caveats

سازگاری کامل با نسخه‌های قبلی به صورت رو به عقب. تنظیم انجام شده روی test.only رفتار را با رد کردن صحیح هوک‌های قبل و بعد از تست اصلاح می‌کند، که ممکن است روی سوئ

نمای کلی اجرایی و اهمیت معماری

بان (Bun) نسخه 1.1.26 به عنوان یک نسخه بسیار هدفمند و در عین حال تأثیرگذار در چرخه تکامل سریع این زمان‌اجرا (runtime) از راه می‌رسد. به جای معرفی تحولات گسترده معماری، این انتشار بر پایدارسازی حالات خاص و بحران‌زا، تقویت سازگاری APIهای Node.js و بهبود درون‌نگری وضعیت بلادرنگ برای برنامه‌های شبکه با پهنای باند بالا تمرکز دارد. با رفع ۹ باگ متمایز که در مجموع بیش از ۶۵۲ رأی مثبت از سوی جامعه توسعه‌دهندگان دریافت کرده بودند، تیم مهندسی پاسخگویی دقیق خود را به نقاط اصطکاک توسعه‌دهندگان در سطح پروداکشن نشان داده است. این نسخه مسیر بان را به سمت برابری به عنوان جایگزینی بی‌دردسر برای بارهای کاری سازمانی پیچیده که به شدت به مدیریت قوی وب‌سوکت، کپسوله‌سازی دقیق ماژول‌های CommonJS و چرخه‌های عمر قابل پیش‌بینی در اجراکننده تست متکی هستند، تثبیت می‌کند.

از دیدگاه معماری، گنجاندن متریک‌های دقیق سرور و گزینه‌های پیکربندی چرخه عمر در Bun.serve() نشان‌دهنده یک فلسفه طراحی در حال بالغ شدن است. برنامه‌های با هم‌روندی بالا اغلب از نشت‌های پنهان منابع و مدیریت مبهم اتصالات رنج می‌برند. با قرار دادن توابع اولیه سطح پایینی مانند تعداد مشترکین و محدودیت‌های زمان انتظار غیرفعال (idle timeout) مستقیماً در لایه زمان‌اجرای جاوا اسکریپت، بان شکاف بین عملکرد خام در سطح سیستم و قابلیت مشاهده در سطح برنامه را پر می‌کند. علاوه بر این، رفع سیستماتیک ناسازگاری‌های ظریف در اجراکننده تست و بارگذار ماژول تضمین می‌کند که پایگاه‌های کد سازمانی مقیاس‌بزرگ در حال مهاجرت از محیط‌های سنتی Node.js/Jest، با رگرسیون‌های پنهان کمتری مواجه شوند و سرعت پذیرش سازمانی تسریع گردد.

بهبودهای اصلی و ارگونومی توسعه‌دهنده

ارگونومی توسعه‌دهنده در نسخه 1.1.26 با معرفی دستور بومی bun outdated جهش قابل توجهی به جلو دارد. پیش از این، توسعه‌دهندگانی که منحصراً به بان متکی بودند مجبور بودند برای بررسی درخت‌های وابستگی جهت یافتن پکیج‌های منسوخ، به ابزارهای شخص ثالث متوسل شوند یا به npm/pnpm بازگردند. دستور داخلی جدید به‌طور بومی package.json را در برابر متداده‌های رجیستری بررسی می‌کند و به طور یکپارچه با فایل قفل باینری فوق‌سریع بان و موتور حل‌کننده پکیج ادغام می‌شود تا بدون برهم زدن وضعیت جریان کاری توسعه‌دهنده، عیب‌یابی به‌روزرسانی و انطباق فوری را ارائه دهد.

همزمان، برنامه‌های وب بلادرنگ ساخته شده روی Bun.serve() دو توابع اولیه قدرتمند دریافت می‌کنند. گزینه پیکربندی جدید idleTimeout به توسعه‌دهندگان کنترل صریحی بر خاتمه چرخه عمر اتصال اعطا می‌کند و مانع از آن می‌شود که کلاینت‌های وب‌سوکت سرکش یا متوقف‌شده، توصیف‌گرهای فایل و حافظه را به طور نامحدود باز نگه دارند. در تکمیل این مورد، متد تازه اضافه شده‌ی subscriberCount(topic: string) به توسعه‌دهندگان اجازه می‌دهد تا تعداد دقیق کلاینت‌های فعال وب‌سوکت مشترک در یک موضوع Pub/Sub مشخص را فورا استعلام کنند. این امر نیاز به لایه‌های پرهزینه ردیابی وضعیت دستی در حافظه را از بین می‌برد و امکان گزارش‌دهی فوری متریک‌ها، قابلیت مشاهده توزیع بار، و جداسازی تمیزتر معماری را در سرورهای چت، داشبوردهای زنده و سیستم‌های بک‌اند چندنفره فراهم می‌کند.

ماتریس مقایسه معماری

ویژگی / متریک مبنای قبلی (v1.1.x) بان نسخه 1.1.26 تأثیر معماری
حسابرسی وابستگی نیازمند ابزار خارجی (npm outdated / pnpm) دستور بومی bun outdated حسابرسی محلی بدون اصطکاک با استفاده از تجزیه‌کننده اصلی فایل قفل.
حدود زمان انتظار وب‌سوکت فقط اکتشافات داخلی پیش‌فرض گزینه قابل تنظیم idleTimeout از اتمام منابع ناشی از سوکت‌های یتیم TCP/وب‌سوکت جلوگیری می‌کند.
درون‌نگری Pub/Sub مدیریت پخش مبهم subscriberCount(topic: string) امکان استعلام مستقیم متریک بدون فروشگاه‌های وضعیت خارجی (مانند Redis).
چرخه عمر تست (test.only) فقط رد کردن تست‌ها پس از اجرا رد کردن هوک‌های راه‌اندازی/پاکسازی به صورت دوطرفه از اجرای اثرات جانبی در طول جلسات دیباگ هدفمند جلوگیری می‌کند.
حالت سخت‌گیرانه CJS حذف‌شده/نادیده‌گرفته‌شده در مرزهای ماژول خاص صراحتاً حفظ‌شده ("use strict") انطباق با حالت سخت‌گیرانه را برای پکیج‌های قدیمی CommonJS npm تضمین می‌کند.

تغییرات اساسی و نکات مهاجرت

بان نسخه 1.1.26 کاملاً با نسخه‌های قبلی v1.1.x سازگار است و هیچ تغییر اساسی در APIهای اصلی یا پرچم‌های اجرای CLI ایجاد نمی‌کند. با این حال، توسعه‌دهندگانی که از قابلیت اولیه test.only در bun:test بهره می‌برند باید از یک اصلاح رفتاری آگاه باشند: تست‌های مشخص‌شده برای حذف اکنون به درستی هم هوک‌های چرخه عمر پیش از تست و هم پس از تست (مانند beforeEach و afterEach) را دور می‌زنند، به جای اینکه منطق پاکسازی را بدون تشخیص اجرا کنند. در حالی که این یک رفع باگ است که بان را با مشخصات Jest و Vitest هم‌راستا می‌کند، سوئیت‌های تستی که به طور تصادفی به اثرات جانبی هوک‌های ردشده در حال اجرای منطق پاکسازی متکی بودند، ممکن است نیاز به تنظیمات جزئی در فایل‌های تست داشته باشند.

راهنمای ارتقای گام‌به‌گام

ارتقا به بان نسخه 1.1.26 نیازمند یک دستور ترمینال واحد است که به سرعت ابزارهای بازرسی CLI جدید و پیکربندی‌های سرور را باز می‌کند.

  1. نصب بان خود را به آخرین نسخه ارتقا دهید:

    bun upgrade
    
  2. پروژه فعلی خود را برای پکیج‌های منسوخ بررسی کنید:

    bun outdated
    
  3. از idleTimeout و subscriberCount جدید در پیاده‌سازی سرور خود بهره ببرید:

    Bun.serve({
      idleTimeout: 30, // قطع اتصال اتصالات غیرفعال پس از 30 ثانیه
      fetch(req, server) {
        if (server.upgrade(req)) return;
        return new Response("Upgrade failed", { status: 400 });
      },
      websocket: {
        message(ws, message) {
          ws.subscribe("updates");
          const activeListeners = ws.subscriberCount("updates");
          ws.send(`Active subscribers on this topic: ${activeListeners}`);
        },
      },
    });
    
#Bun#v1.1.26#DevTools#Release#Changelog
Editorial MethodologyRelease Intelligence & Verification Standards

OPA Release analyzes upstream repository commits, official changelogs, and runtime telemetry assisted by automated synthesis pipelines and verified under our Editorial Standards. Review our Affiliate Disclosure and Software Disclaimer before deploying changes to production environments.

Frequently Asked Questions

What are the key enhancements in Bun v1.1.26?▼

Key enhancements include: دستور بومی `bun outdated` برای حسابرسی با سرعت بالای وابستگی‌ها مستقیماً از فایل قفل زمان‌اجرای اصلی.; گزینه جدید `idleTimeout` در `Bun.serve()` برای کنترل دقیق روی اتصالات وب‌سوکت قطع‌شده و پاسخ‌گو.; معرفی `subscriberCount(topic: string)` برای حافظه بلادرنگ و درون‌نگری کلاینت در معماری‌های وب‌سوکت Pub/Sub..

Are there breaking changes in Bun v1.1.26?▼

سازگاری کامل با نسخه‌های قبلی به صورت رو به عقب. تنظیم انجام شده روی `test.only` رفتار را با رد کردن صحیح هوک‌های قبل و بعد از تست اصلاح می‌کند، که ممکن است روی سوئ

How do developers upgrade to Bun v1.1.26?▼

Refer to the step-by-step upgrade guide and official release manifest linked in this analysis, ensuring environment dependencies are verified.

OPA NETWORK EXPLORER

Deep Dive Across the Ecosystem