Node.js 24 LTS؛ به‌روزرسانی را با آزمون درخواست‌ها انجام دهیم

خبر انتشار را به برنامه آزمون تبدیل کنید

انتشار Node.js 24.21.0 در هشتم سپتامبر ۲۰۲۶ برای شاخه LTS، به‌روزرسانی‌هایی در وابستگی‌های رمزنگاری، گواهی‌های ریشه و کتابخانه‌های شبکه معرفی کرده است. خبر نسخه برای تیم نرم‌افزار فقط یک شماره جدید نیست؛ فرصتی است که وضعیت runtime و رفتار سرویس بررسی شود. این مقاله ادعا نمی‌کند همه پروژه‌ها باید به همین patch منتقل شوند. هنگام اجرا، جدیدترین patch مناسب شاخه انتخابی را از منبع رسمی بررسی کنید و release notes فاصله نسخه فعلی تا مقصد را بخوانید.

LTS درباره چرخه پشتیبانی است، نه تضمین سازگاری بدون آزمون با هر بسته. افزونه‌های native، نسخه npm، فایل lock، روش build و سیستم‌عامل target باید در بررسی باشند. اگر از image آماده استفاده می‌کنید، tag و digest واقعاً اجراشده را ثبت کنید؛ نسخه Node لپ‌تاپ ممکن است با container متفاوت باشد. انتخاب مقصد را به سیاست پروژه وصل کنید: شاخه پشتیبانی‌شده، ابزارهای سازگار و مسیر نصب تکرارپذیر. جابه‌جایی به شاخه Current بدون نیاز مشخص، جای رسیدگی به شاخه LTS موجود را نمی‌گیرد.

سازگاری را در مسیر واقعی بررسی کنید

تغییر گواهی و OpenSSL می‌تواند اهمیت عملی داشته باشد، مخصوصاً وقتی سامانه به سرویس داخلی با CA اختصاصی وصل می‌شود. اتصال واقعی به دیتابیس، API، پراکسی و endpoint پرداخت آزمایشی را بررسی کنید. خاموش کردن بررسی گواهی برای عبور از خطا، راه حل مهاجرت نیست؛ زنجیره اعتماد و تنظیمات CA باید درست شوند. خطای network و timeout را جدا از خطای منطق برنامه ثبت کنید تا تغییر نسخه باعث اشتباه گرفتن یک مشکل اتصال با تغییر API نشود.

context درخواست برای correlation ID و مشاهده‌پذیری مهم است. AsyncLocalStorage راهی برای نگه داشتن context در مسیر ناهم‌زمان فراهم می‌کند و در شاخه ۲۴ نیز باید با کتابخانه‌های واقعی برنامه آزموده شود. مثال این مقاله دو درخواست هم‌زمان را شبیه‌سازی می‌کند و بررسی می‌کند شناسه‌ها جابه‌جا نمی‌شوند. این ویژگی مجوز یا جداسازی داده سازمان نیست؛ صرفاً context اجرایی است. اگر در background task یا callback کتابخانه‌ای context گم می‌شود، تست کوچک کافی نیست و همان مسیر واقعی باید بازتولید شود.

پیشنهاد تحریریه این است که CI یک ماتریس نسخه فعلی و مقصد داشته باشد. تست‌های واحد، قرارداد API و نصب production dependency را در هر دو اجرا کنید. سپس یک نمونه بار مشابه تولید را بسنجید: تأخیر صدک ۹۵، حافظه، event-loop delay و نرخ خطا. میانگین بهتر همراه با جهش تأخیر در تعداد کمی درخواست، نتیجه کامل نیست. تغییر runtime و به‌روزرسانی عمده framework را هم‌زمان انجام ندهید مگر آنکه بتوانید علت اختلاف را جدا نشان دهید؛ بازبینی و برگشت باید قابل انجام باشند.

import test from 'node:test';
import assert from 'node:assert/strict';
import { AsyncLocalStorage } from 'node:async_hooks';
import { setTimeout as delay } from 'node:timers/promises';

const context = new AsyncLocalStorage();
async function simulateRequest(id, wait) {
  return context.run({ requestId: id }, async () => {
    await delay(wait);
    return context.getStore().requestId;
  });
}
test('parallel requests retain their own context', async () => {
  const result = await Promise.all([
    simulateRequest('order-A', 20),
    simulateRequest('order-B', 1),
  ]);
  assert.deepEqual(result, ['order-A', 'order-B']);
  assert.equal(context.getStore(), undefined);
});

انتشار کم‌دامنه با نتیجه قابل مقایسه

انتشار را با یک سرویس یا درصد محدود ترافیک شروع کنید و artifact قبلی را نگه دارید. پس از تثبیت اتصال‌ها و معیارهای عملیاتی، درباره استفاده از قابلیت‌های تازه تصمیم بگیرید. نتیجه تحویل باید نسخه واقعی runtime، dependencyهای تغییرکرده، مسیرهای آزموده‌شده و مدت پایش را ثبت کند. کد کوتاه node:test زیر از ابزار داخلی runtime استفاده می‌کند تا یک رفتار مهم قابل تکرار شود؛ این نمونه جای تست HTTP، session و پایگاه داده برنامه نیست، اما برای شروع بررسی context درخواست‌ها مفید است.

تاریخ انتشار منبع: 2026-09-08. توضیح‌ها و پیشنهادهای اجرایی این مطلب، تحلیل تحریریه دانشنامه لیان هستند.منابع: Node.js — 24.21.0 LTS release notes · Node.js — Major-version changes in 24 · Node.js — Test runner · Node.js — Async context

این مطلب بازنویسی تحلیلی دانشنامه لیان بر پایه منبع اصلی است.مشاهده منبع اصلی