نمای کلی اجرایی و اهمیت معماری
بان (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 جدید و پیکربندیهای سرور را باز میکند.
نصب بان خود را به آخرین نسخه ارتقا دهید:
bun upgradeپروژه فعلی خود را برای پکیجهای منسوخ بررسی کنید:
bun outdatedاز
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}`); }, }, });
