Ръководство за съвместимост
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 разпространяваше това поетапно от октомври 2024 г., затова някои потребители го видяха по-късно.
10.2024 г.Google започва поетапното разпространение към потребителите.Документация на Chrome129Стойността по подразбиране в кода започва да изключва MV2.Измерено
Двата формата съжителстват, MV3 се допълва
Работят и MV2, и MV3 – най-снизходителният период. Новите API на MV3 идват едно по едно; разширение, което ги използва, без да посочва минимална версия, се инсталира в по-стари браузъри, но тези функции не работят.
127–128MV2 още работи; Chrome започва да предупреждава за края на MV2 на страницата с разширения.Измерено120Разрешението userScripts е налично (потребителят трябва и да го включи).Документация на Chrome114sidePanel е наличен.Измерено109API offscreen е наличен; по-ранните версии се инсталират и работят, но извикванията се провалят.Измерено01.2022 г.Уеб магазинът на Chrome спира да приема нови разширения с MV2 (правило на магазина, не промяна в браузъра).Правила на магазина96Разрешението declarativeNetRequestWithHostAccess е налично.Документация на Chrome92Фонове с ES модули започват да работят.Измерено
MV3 стига до стабилната версия
От Chrome 88 разширенията с MV3 се инсталират и работят. Фон, написан като ES модул ("type": "module"), обаче до версия 92 се инсталира, без никога да се стартира.
88–91Фон-модул се показва със service worker, но никога не стартира.Измерено88Основен MV3: инсталиране, включване и фон работят.Измерено
Годините само с 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.
- Проверете минималната версия: под нея инсталирането се отказва.
- В стар браузър изберете най-новата съвместима версия или първо актуализирайте.
Метод и ограничения
Тествано на 18.10.2026 г. в 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 следват свои графици; тук не са тествани.