jQuery Migrate: مهاجرت راحتتر به jQuery 4
جاوااسکریپت
فرانتاندخلاصهٔ کاملتر
آپگرید کردن کتابخونههایی مثل jQuery وقتی تغییرات ناسازگار (breaking change) دارن، میتونه کلی کار ببره. افزونهٔ jQuery Migrate دقیقاً برای همینه: APIهایی که تو نسخهٔ جدید حذف شدن رو دوباره برمیگردونه، تا کدت بدون بازنویسی فوری کار کنه. بعد هر جا از API حذفشده یا منسوخ استفاده کرده باشی، تو کنسول مرورگر بهت هشدار میده که همونجا پیداش کنی و درستش کنی.
ایدهٔ اصلی اینه که Migrate یه ابزار موقته؛ ازش استفاده میکنی تا کارهای عقبمونده رو مرتب کنی و بعد که دیگه بهش نیاز نداشتی، از پروژه برش میداری. هر نسخهٔ Migrate با یه نسخهٔ jQuery جوره؛ مثلاً Migrate 4.x برای jQuery 4.xه و همون مرورگرهایی رو پشتیبانی میکنه که خود اون نسخهٔ jQuery پشتیبانی میکنه.
یه نکتهٔ مهم برای رفتن به jQuery 4 اینه که باید اول روی نسخهٔ 3.x باشی. اگه نسخهٔ قدیمیتری داری، اول باید با jQuery Migrate 3.x مشکلهای سازگاری رو حل کنی و به jQuery 3.x برسی، بعد سراغ ۴ بری. تو استفاده هم افزونه رو باید بعد از تگ اسکریپت خود jQuery لود کنی.
دو تا نسخهٔ ساخت داره: نسخهٔ توسعه که هشدارها رو تو کنسول نشون میده و برای دیباگه، و نسخهٔ production که مینیفای شده و هشدار تولید نمیکنه (فقط موقع لود یا موقع خطای جدی یه پیام میده). همهٔ هشدارها هم با رشتهٔ «JQMIGRATE» شروع میشن تا راحت تشخیصشون بدی.
افزونه یه سری قابلیت برنامهنویسی هم اضافه میکنه که باهاش رفتارش رو کنترل میکنی. مثلاً jQuery.migrateMessages آرایهای از همهٔ هشدارهاست، jQuery.migrateMute هشدارهای کنسول رو خاموش میکنه، jQuery.migrateTrace نمایش رد پشتهٔ خطا رو کنترل میکنه و با jQuery.migrateDisablePatches میتونی وصلهها رو با کد خودشون غیرفعال کنی. اینها کمک میکنن دقیقاً همون چیزی که لازم داری رو ببینی.
نکات کلیدی:
- jQuery Migrate آپگرید نسخهٔ jQuery رو با برگردوندن APIهای حذفشده راحتتر میکنه.
- تو نسخهٔ توسعه، استفاده از API قدیمی یا منسوخ رو تو کنسول هشدار میده.
- برای رفتن به jQuery 4 باید اول با Migrate 3.x به jQuery 3.x برسی.
- افزونه رو همیشه بعد از خود jQuery لود کن.
- خصوصیتهایی مثل migrateMute و migrateDisablePatches کنترل رفتار افزونه رو میدن.
