DNSimple چطور Vue و jQuery رو با Stimulus عوض کرد
خلاصهٔ کاملتر
این دومین پست از مجموعه مقالههای DNSimple درباره رفتن به پیشفرضهای Rails 8.1 هست. اپ اونا اولش حدود ۵۰ کامپوننت Vue و کلی کد jQuery داشت و الان هیچکدوم نمونده. نویسنده میگه قبلاً منطق کسبوکار دو جا بود: Ruby روی سرور و جاوااسکریپت تو مرورگر. حالا فقط یه جاست و جاوااسکریپتی که مونده فقط از Stimulus استفاده میکنه.
دلیل حذف Vue این بود که importmaps (یعنی لود کردن ماژولهای JS بدون bundler) نمیتونه فایلهای single-file component رو کامپایل کنه، پس Vue یه build step جدا لازم داشت. jQuery هم یه مشکل دیگه داشت: اسکریپتها روی رویداد DOMContentLoaded به سلکتورهای js-* وصل میشدن. ولی Turbo Drive (یعنی ابزاری که بدون رفرش کامل، فقط body صفحه رو عوض میکنه) این رویداد رو تو هر بار رفتن به صفحه جدید صدا نمیزنه، پس اون اسکریپتها کار نمیکردن.
تیم برای هر کامپوننت سه تا سؤال پرسید: یک، آیا یه المنت HTML خودش بدون جاوااسکریپت از پسش برمیاد؟ دو، اگه نه، میشه HTML رو سرور بسازه به جای اینکه مرورگر JSON بگیره و خودش HTML بسازه؟ سه، اگه هیچکدوم، کوچیکترین تیکه جاوااسکریپتی که میتونه باقی کار رو انجام بده چیه؟ نتیجه این شد که همیشه جواب Stimulus نبود. مثلاً المنت جای modal ساختهشده با Vue رو گرفت، بعضی ویجتها Web Component شدن و بعضیها هم یه Turbo Frame ساده بدون هیچ JS.
مثال اصلی مقاله پاپآپ چک کردن DNS هست. قبل از کارهایی مثل اضافه کردن رکورد یا گرفتن گواهی، اپ چک میکنه دامنه درست به DNSimple اشاره میکنه یا نه. نسخه قدیمی یه کامپوننت Vue با ۳۵۰ خط، ۱۷ تا prop و شش تیکه state بود که JSON میگرفت و HTML پنج حالت خطا رو تو مرورگر میساخت. هر صفحهای هم که ازش استفاده میکرد سه تا کوئری اضافه (دامنه، دسترسی، قیمت) میزد فقط برای پر کردن propها.
حالا سرور همه حالتها رو رندر میکنه و endpoint به جای JSON، HTML برای Turbo Frame برمیگردونه. کنترلر Stimulus فقط یه value داره (آدرس چک) و فقط کارهایی رو میکنه که frame خودش نمیتونه: کلیک رو میگیره، dialog رو باز میکنه، بعد از تأیید همون کلیک رو دوباره اجرا میکنه و برای «تا ۲۴ ساعت دیگه چک نکن» یه کوکی میذاره:
continue (event) {
event?.preventDefault();
this._close();
if (!this.pendingAction) return;
const action = this.pendingAction;
this.pendingAction = null;
this.bypassedAction = action;
action.click();
}فلگ bypassedAction نمیذاره کنترلر کلیک خودش رو دوباره بگیره. جالبه که تعداد خطها خیلی کم نشد: از حدود ۴۳۰ به حدود ۴۰۰. ولی نویسنده میگه موفقیت رو نباید با خطهای حذفشده سنجید، باید دید مرورگر چقدر کمتر لازمه بدونه. پست بعدی درباره رفتن از Bootstrap و Tachyons به Tailwind هست.
نکات کلیدی:
- DNSimple حدود ۵۰ کامپوننت Vue و همه کدهای jQuery رو حذف کرد.
- Vue با importmaps کامپایل نمیشد و build step جدا لازم داشت.
- اسکریپتهای jQuery روی DOMContentLoaded بودن که Turbo Drive تو هر بار رفتن به صفحه جدید صداش نمیزنه.
- کامپوننت ۳۵۰ خطی چک DNS با ۱۷ prop شد یه Turbo Frame و یه کنترلر Stimulus ۱۹۲ خطی.
- صفحهها دیگه سه تا کوئری اضافه برای رندر این چک نمیزنن.
- قانون سهمرحلهای: اول HTML خالص، بعد رندر سمت سرور، آخر کوچیکترین JS ممکن.




