راهنمای سازگاری
Manifest V2 و Manifest V3: هر نسخهٔ Chrome چه چیزی را می‌تواند نصب کند
از Chrome 87 تا 156، خط نسخه‌ها را دنبال کنید تا ببینید هر قالب افزونه کی کار می‌کند، کی از کار می‌افتد و پیش از دانلود نسخهٔ قدیمی‌تر چه چیزی را باید بررسی کنید.
Manifest V2 و Manifest V3 چیست
- Manifest V2
- قالب قدیمی افزونه‌های Chrome. افزونه‌ها با یک صفحهٔ پس‌زمینهٔ همیشگی اجرا می‌شوند و می‌توانند درخواست‌های شبکه را مستقیم رهگیری و تغییر دهند. Chrome در حال کنار گذاشتن آن است.
- Manifest V3
- قالب فعلی که از Chrome 88 پشتیبانی می‌شود. پس‌زمینه به service worker تبدیل می‌شود که فقط هنگام نیاز اجرا می‌شود، فیلتر شبکه از قاعده‌های اعلانی (declarativeNetRequest) استفاده می‌کند و مجوزها سخت‌گیرانه‌ترند.
فایل manifest.json هر افزونه مشخص می‌کند از کدام قالب استفاده می‌کند؛ در ادامه به‌اختصار MV2 و MV3 می‌گوییم.
Manifest V2 از بین رفته است
مرورگر دیگر هیچ سوئیچ یا سیاستی برای MV2 ندارد؛ هر روشی رد می‌شود. MV3 سقفی ندارد — از 88 تا 156، جدیدترین نسخهٔ آزمایش‌شده، کار کرد. تنها خطر باقی‌مانده مرورگری بیش از حد قدیمی است.
156جدیدترین نسخهٔ آزمایش‌شده: MV2 همه‌جا رد می‌شود، MV3 کار می‌کند.اندازه‌گیری151همهٔ سوئیچ‌های خط فرمان حذف شدند.اندازه‌گیری
MV2 رد می‌شود
برای کاربران عادی، MV2 تمام شده است: نصب رد می‌شود و نمی‌توان دوباره روشنش کرد؛ حالت توسعه‌دهنده و «بارگیری بسته‌بندی‌نشده» کمکی نمی‌کنند. فقط سیاست سازمانی (تا 138) و سوئیچ‌های خط فرمان (تا 150) آن را زنده نگه می‌دارند.
150آخرین نسخه‌ای که سوئیچ‌های خط فرمان در آن کار می‌کنند (با یک روشن‌سازی اضافه).اندازه‌گیری139سیاست سازمانی ExtensionManifestV2Availability حذف می‌شود.اندازه‌گیری137MV2 به‌طور پیش‌فرض رد می‌شود؛ روشن کردن دوباره ممکن نیست.اندازه‌گیری
MV2 به‌طور پیش‌فرض خاموش
افزونه‌های MV2 هنوز نصب می‌شوند، اما خاموش می‌رسند (unsupportedManifestVersion). کاربر می‌تواند آن‌ها را از chrome://extensions دوباره روشن کند و عادی کار می‌کنند. Google این را از اکتبر ۲۰۲۴ به‌تدریج منتشر کرد، بنابراین برخی کاربران دیرتر با آن روبه‌رو شدند.
مهر ۱۴۰۳Google انتشار تدریجی برای کاربران را آغاز می‌کند.مستندات Chrome129مقدار پیش‌فرض کد شروع به خاموش کردن MV2 می‌کند.اندازه‌گیری
هر دو قالب کنار هم، MV3 کامل‌تر می‌شود
هم MV2 و هم MV3 کار می‌کنند — سهل‌گیرترین دوره. APIهای جدید MV3 یکی‌یکی می‌آیند؛ افزونه‌ای که بدون اعلام کمترین نسخه از آن‌ها استفاده کند در مرورگرهای قدیمی نصب می‌شود، اما آن قابلیت‌ها کار نمی‌کنند.
127–128MV2 هنوز کار می‌کند؛ Chrome در صفحهٔ افزونه‌ها دربارهٔ پایان MV2 هشدار می‌دهد.اندازه‌گیری120مجوز userScripts در دسترس است (کاربر هم باید آن را روشن کند).مستندات Chrome114sidePanel در دسترس است.اندازه‌گیری109API offscreen در دسترس است؛ نسخه‌های قبلی نصب و اجرا می‌شوند، اما فراخوانی‌ها شکست می‌خورند.اندازهگیریدی ۱۴۰۰فروشگاه وب Chrome دیگر افزونهٔ MV2 جدید نمی‌پذیرد (سیاست فروشگاه، نه تغییر مرورگر).سیاست فروشگاه96مجوز declarativeNetRequestWithHostAccess در دسترس است.مستندات Chrome92پس‌زمینه‌های ماژول ES شروع به کار می‌کنند.اندازه‌گیری
MV3 به نسخهٔ پایدار می‌رسد
از Chrome 88 افزونه‌های MV3 نصب و اجرا می‌شوند. اما پس‌زمینه‌ای که به‌صورت ماژول ES ("type": "module") نوشته شده، تا نسخهٔ 92 نصب می‌شود ولی هرگز اجرا نمی‌شود.
88–91پس‌زمینهٔ ماژولی با service worker نمایش داده می‌شود اما هرگز شروع نمی‌شود.اندازه‌گیری88MV3 پایه: نصب، روشن‌شدن و اجرای پس‌زمینه کار می‌کند.اندازه‌گیری
سال‌های فقط MV2
Manifest V2 تنها قالب پایدار است. افزونهٔ MV3 در Chrome پایدار نصب می‌شود و روشن به نظر می‌رسد، اما اسکریپت پس‌زمینه‌اش هرگز اجرا نمی‌شود — سخت‌ترین خرابی برای تشخیص.
87نسخهٔ پایدار 87 حداکثر manifest_version 2 را می‌پذیرد؛ پس‌زمینه‌های service_worker فقط در کانال Dev هستند.کد منبع
از Chrome 137، MV2 رد می‌شود و کاربران عادی هیچ راه دورزدنی ندارند.
Chrome 129–136 افزونه‌های MV2 را خودکار خاموش می‌کند، اما کاربران می‌توانند آن‌ها را دوباره روشن کنند.
MV3 به Chrome 88 یا جدیدتر نیاز دارد؛ مرورگرهای قدیمی‌تر آن را نصب می‌کنند اما هرگز اجرا نمی‌کنند.
پیش از دانلود نسخهٔ قدیمی‌تر
- نسخهٔ مانیفست را بررسی کنید: در Chrome 137 و جدیدتر فقط MV3 را انتخاب کنید.
- کمترین نسخه را بررسی کنید: پایین‌تر از آن، نصب رد می‌شود.
- در مرورگر قدیمی، جدیدترین نسخهٔ سازگار را انتخاب کنید یا ابتدا به‌روزرسانی کنید.
روش و محدودیت‌ها
در ۱۸ اکتبر ۲۰۲۶ روی Linux با Chrome for Testing 113–156 و نسخه‌های لحظه‌ای Chromium 87–112 آزمایش شد، با افزونه‌های آزمایشی و Google Translate 2.0.13 / 2.0.18 و AdBlock واقعی تا «نصب‌شده»، «روشن» و «پس‌زمینه واقعاً اجرا می‌شود» از هم جدا شوند؛ مسیر نصب CRX با نصب اجباری از طریق سیاست سازمانی بررسی شد. Chrome for Testing انتشار تدریجی ندارد، پس نسخه‌های بالا نشان می‌دهند کد کی اعمال می‌شود — کاربران واقعی ممکن است تغییرات را دیرتر دیده باشند. Windows، Mac، Edge و دیگر مرورگرهای Chromium پوشش داده نشدند. تاریخ‌های پس از 150 بر اساس چرخهٔ انتشار چهارهفته‌ای Chrome تخمین زده شده‌اند.
Edge و دیگر مرورگرهای Chromium برنامهٔ زمانی خودشان را دارند؛ این‌جا آزمایش نشدند.