نمای کلی اجرایی و اهمیت معماری
نسخه ۱.۲.۱۲ Bun به عنوان یک نسخه متمرکز و تأثیرگذار در اکوسیستم زمان اجرای جاوا اسکریپت ارائه می‌شود و مسیر اتصال زیرساخت بومی با کارایی بالا را با قابلیت‌های جایگزینی یکپارچه استاندارد Node.js و مرورگر ادامه می‌دهد. از آنجا که بارهای کاری سازمانی به دلیل زمان‌های راه‌اندازی سرد بسیار سریع و ابزار یکپارچه، به طور فزاینده‌ای به Bun مهاجرت می‌کنند، حفظ سازگاری دقیق با APIهای قدیمی Node.js در کنار پیشبرد مرزهای ارگونومی توسعه‌دهنده همچنان از اهمیت بالایی برخوردار است. این نسخه حلقه‌های بازخورد حیاتی را در جریان‌های کاری توسعه محلی هدف قرار می‌دهد و به‌طور خاص به پراکندگی بین خطاهای زمان اجرا در سمت مرورگر و قابلیت مشاهده ترمینال در سمت سرور می‌پردازد.
از منظر معماری، ادغام استریم لاگ‌های کنسول مرورگر به ترمینال نیازمند هماهنگی پیچیده حلقه رویداد (event-loop) و پل‌های ارتباطی بین موتور جاسازی‌شده JavaScriptCore (JSC) و بافر خروجی ترمینال است. Bun با استریم مستقیم خروجی‌های کنسول مرورگر به نمونه ترمینال توسعه‌دهنده، سربار تغییر زمینه (context-switching) را حذف می‌کند و به طور مؤثری حلقه بازخورد اشکال‌زدایی فول‌استک را فشرده می‌سازد. همزمان، بهینه‌سازی‌های حافظه داخلی در طول چرخه عمر سرور توسعه، تعهد مستمر تیم اصلی را به بهره‌وری منابع برجسته می‌کند و تضمین می‌نماید که جلسات توسعه محلی طولانی‌مدت حتی تحت فشار بالای بارگذاری مجدد ماژول‌ها، مصرف حافظه بهینه‌ای را حفظ کنند.
بهبودهای کلیدی و ارگونومی توسعه‌دهنده
ویژگی برجسته Bun v1.2.12، استریم بومی لاگ‌های کنسول مرورگر مستقیماً به محیط ترمینال است. پیش از این، اشکال‌زدایی اسکریپت‌های سمت کاربر اجرا شده از طریق اجراکننده تست Bun یا سرورهای SSR مستقیماً نیازمند بازرسی ابزارهای توسعه‌دهنده مرورگر (DevTools) یا گرفتن دستی stdout از طریق کدهای اضافی پرجایگزین بود. این نسخه یک خط لوله خودکار و دوطرفه را پیاده‌سازی می‌کند که متدهای کنسول (console.log، error، warn، info) را از زمینه مرورگر گرفته و به صورت تمیز به ترمینال هدایت می‌کند و با وضوح نقشه منبع (source-map) و نشانگرهای شدت رنگ‌بندی‌شده تکمیل می‌شود. این امر توسعه فول‌استک را به طور قابل توجهی ساده‌تر کرده و توسعه‌دهندگان را در فضای کاری اصلی CLI خود نگه می‌دارد.
علاوه بر به‌روزرسانی‌های قابلیت مشاهده، نسخه ۱.۲.۱۲ مجموعه گسترده‌ای از بهبودهای سازگاری با Node.js را ارائه می‌دهد. ماژول‌های اصلی از جمله timers، vm، net و http پچ‌های معماری عمیقی را برای رفع تناقضات رفتاری در شرایط خاص دریافت کرده‌اند که پیش‌تر باعث خرابی فریم‌ورک‌های پیچیده یا مجموعه‌های تست می‌شدند. نکته مهم اینکه، این نسخه اشکالات پایداری آزاردهنده مربوط به بارگذاری داغ (hot reloading) را در کنار اصلاحات سطح تجزیه‌کننده در TextDecoder برطرف می‌کند. این بهبودها تضمین می‌کنند که بیلدهای افزایشی و سرورهای بارگذاری زنده دچار نشتی حافظه یا بسته‌های ماژول قدیمی نمی‌شوند و مستقیماً به یک تجربه توسعه روزمره مقاوم‌تر تبدیل می‌شوند.
ماتریس مقایسه معماری
| معیار / بعد | مبنای قبلی (v1.2.x) | معماری Bun v1.2.12 | تأثیر معماری |
|---|---|---|---|
| مصرف حافظه سرور توسعه | تورم پایه متوسط در طول چرخه‌های بارگذاری مجدد داغ مداوم. | کش داخلی بهینه‌شده و محرک‌های جمع‌آوری زباله (garbage collection). | کاهش ماندگاری حافظه در جلسات توسعه محلی طولانی‌مدت. |
| تأخیر لاگ‌برداری مرورگر | قطع‌شده؛ نیازمند بازرسی دستی DevTools یا هوک‌های سفارشی. | مسیردهی استریم IPC بومی برای فراخوانی‌های کنسول مرورگر به ترمینال. | حلقه بازخورد تقریباً آنی برای اشکال‌زدایی فول‌استک. |
| سازگاری با Node.js (net/http/vm) | عدم تطابق پشته گاه‌به‌گاه و موارد لبه حل‌نشده. | اتصالات سخت‌افزاری و دیسپچرهای داخلی بازنویسی‌شده. | نرخ موفقیت بالاتر خارج از جعبه برای کدهای قدیمی سازمانی Node.js. |
| پایداری TextDecoder | خطاهای رمزگشایی وقفه دار روی بافرهای استریم ناقص. | پایبندی دقیق به مشخصات استاندارد کدگذاری (Encoding Standard). | حذف خرابی خاموش داده‌ها هنگام تجزیه استریم‌های UTF-8 قطعه‌قطعه شده. |
تغییرات ناسازگار و هشدارهای مهاجرت
Bun نسخه ۱.۲.۱۲ کاملاً با نسخه‌های قبلی در چرخه عمر v1.x سازگار است. هیچ تغییر ناسازگاری در APIهای عمومی، پرچم‌های CLI یا طرح‌بندی‌های پیکربندی وجود ندارد. برنامه‌های موجودی که از اجراکننده تست، مدیر بسته یا سرور HTTP پلتفرم Bun استفاده می‌کنند، می‌توانند بلافاصله بدون نیاز به تغییرات کد یا به‌روزرسانی وابستگی‌ها، ارتقا پیدا کنند.
راهنمای گام‌به‌گام ارتقا
ارتقا به Bun v1.2.12 تنها چند ثانیه با استفاده از دستور ارتقای رسمی طول می‌کشد. برای انتقال محیط توسعه خود این مراحل را دنبال کنید:
ارتقای باینری Bun از طریق دستور ترمینال:
bun upgradeبررسی نصب با چک کردن رشته نسخه فعال:
bun --version # خروجی مورد انتظار: 1.2.12تست سرور توسعه با قابلیت استریم لاگ کنسول مرورگر جدید فعال شده تا مطمئن شوید خط لوله لاگ‌برداری شما در تنظیمات محلی‌تان به درست کار می‌کند:
bun --hot run src/index.ts