Jeasx 3.0 منتشر شد: استریم صفحهها و رندر دو برابر سریعتر
خلاصهٔ کاملتر
Jeasx یه فریمورک برای رندر JSX سمت سرور روی Fastify و esbuildه و نسخهی 3.0.0 اون تو ۲ نوامبر ۲۰۲۶ منتشر شد. مهمترین تغییر اینه که صفحهها حالا با jsxToStream استریم میشن، نه jsxToString. یعنی مرورگر بایتهای اول رو میگیره، در حالی که بخشهای کند (مثلاً جایی که منتظر دادهای) هنوز دارن رندر میشن. این کار با jsx-async-runtime@3 انجام میشه که به گفتهی تیم Jeasx حدود دو برابر سریعتر از نسخهی ۲ رندر میکنه.
این تغییر روی responseHandler اثر میذاره: payload دیگه یه string نیست و یه ReadableStreamه. اگه فقط هدر ست میکنی مشکلی نیست، ولی اگه HTML رو تغییر میدی (مثلاً minify)، اول باید استریم رو به string تبدیل کنی:
if (payload instanceof ReadableStream) {
payload = (await Array.fromAsync(payload)).join("");
}صفحههایی که اینطوری پردازش بشن دیگه استریم نمیشن. this.errorHandler هم حذف شده و باید با setErrorHandler تو jeasx.config.js یه handler برای Fastify ثبت کنی. یه نکتهی مهم: این handler فقط برای خطاهای قبل از ارسال اولین تیکه اجرا میشه. اگه وسط استریم یه کامپوننت async خطا بده، صفحه نصفه قطع میشه. راهحل پیشنهادی تیم، یه error boundaryه که کامپوننت پرریسک رو اول با jsxToString به string تبدیل کنه و تو خطا یه fallback برگردونه.
تغییرهای ناسازگار دیگه هم هست: request.path حالا decodeشدهست، پس باید decodeURIComponent رو از مسیرها برداری چون decode دوباره رو مسیرهای دارای % خراب میشه. jeasx dev فقط روی localhost گوش میده و برای کانتینر یا VM باید HOST رو ست کنی. importهای ناموجود حالا خطا میدن، بهجای اینکه بیصدا به ۴۰۴ برسن. وقتی هیچ routeی جواب نده، پاسخ ۴۰۴ه نه یه ۲۰۰ خالی، و پوشهی dist قبل از هر build پاک میشه.
بخش امنیتی هم قابل توجهه. تو حالت development فایلهای کامپایلشدهی routeهای سرور و sourcemapهاشون از dist قابل دانلود بودن، یعنی کد سمت سرور لو میرفت. حالا سرو نمیشن، حتی با ترفندهای ویندوزی. routeهای خاص مثل [index] یا [...guard] دیگه با اسم مستقیم صدا زده نمیشن، مسیرهای با encoding خراب، null byte یا بخشهای نقطهای با کد ۴۰۰ رد میشن و اسلشهای تکراری ادغام میشن تا آدرس با یه هاست دیگه اشتباه گرفته نشه.
تو خود jsx-async-runtime@3 هم قالب {{ html: "..." }} دیگه چیزی رندر نمیکنه و باید از تابع html() استفاده کنی، چون اون قالب یه راه تزریق از طریق JSON پارسشده باز میکرد. خاموش کردن escape هم دیگه ممکن نیست، class و style باید string باشن (مثلاً با clsx) و children مثل React دستنخورده پاس داده میشه. از امکانات تازه هم میشه به async شدن گزینههای config، اضافه شدن dotfileها به build پروداکشن و خاموش شدن تمیز سرور با SIGINT و SIGTERM اشاره کرد.
نکات کلیدی:
- Jeasx 3.0.0 صفحههای JSX رو با jsxToStream استریم میکنه.
- jsx-async-runtime@3 حدود ۲ برابر سریعتر از نسخهی ۲ رندر میکنه.
- payload تو responseHandler حالا ReadableStreamه و this.errorHandler حذف شده.
- تو dev فایلهای کامپایلشدهی سرور و sourcemapها دیگه قابل دانلود نیستن.
- {{ html: ... }} جاشو به تابع html() داده و class/style باید string باشن.




