Przewodnik po zgodności
Manifest V2 i Manifest V3: co może zainstalować każda wersja Chrome
Od Chrome 87 do 156: wzdłuż linii wersji widać, kiedy działa każdy format rozszerzeń, kiedy przestaje i co sprawdzić przed pobraniem starszej wersji.
Czym są Manifest V2 i Manifest V3
- Manifest V2
- Starszy format rozszerzeń Chrome. Rozszerzenia działają ze stałą stroną w tle i mogą bezpośrednio przechwytywać oraz zmieniać żądania sieciowe. Chrome go wycofuje.
- Manifest V3
- Obecny format, obsługiwany od Chrome 88. Tło staje się service workerem uruchamianym na żądanie, filtrowanie sieci korzysta z reguł deklaratywnych (declarativeNetRequest), a uprawnienia są bardziej rygorystyczne.
Plik manifest.json każdego rozszerzenia określa używany format; dalej skrótowo MV2 i MV3.
Koniec Manifest V2
Przeglądarka nie zawiera już żadnego przełącznika ani zasady MV2; każda metoda jest odrzucana. MV3 nie ma górnej granicy — działało od 88 do 156, najnowszej testowanej wersji. Jedynym pozostałym ryzykiem jest zbyt stara przeglądarka.
156Najnowsza testowana wersja: MV2 wszędzie odrzucane, MV3 działa.Zmierzone151Wszystkie przełączniki wiersza poleceń usunięte.Zmierzone
MV2 odrzucane
Dla zwykłych użytkowników MV2 się skończyło: instalacja jest odrzucana i nie da się jej ponownie włączyć; tryb dewelopera i „Załaduj rozpakowane” nie pomagają. Utrzymać je mogą tylko zasady firmowe (do 138) i przełączniki wiersza poleceń (do 150).
150Ostatnia wersja, w której działają przełączniki wiersza poleceń (z dodatkowym ponownym włączeniem).Zmierzone139Usunięto zasadę firmową ExtensionManifestV2Availability.Zmierzone137MV2 domyślnie odrzucane; nie można go ponownie włączyć.Zmierzone
MV2 domyślnie wyłączone
Rozszerzenia MV2 nadal się instalują, ale trafiają wyłączone (unsupportedManifestVersion). Użytkownik może je ponownie włączyć w chrome://extensions i wtedy działają normalnie. Google wdrażało to stopniowo od października 2024 r., więc niektórzy zobaczyli zmianę później.
paź 2024Google zaczyna stopniowe wdrażanie u użytkowników.Dokumentacja Chrome129Domyślne ustawienie w kodzie zaczyna wyłączać MV2.Zmierzone
Oba formaty obok siebie, MV3 się uzupełnia
Działają i MV2, i MV3 — najbardziej wyrozumiały okres. Nowe API MV3 pojawiają się po kolei; rozszerzenie, które z nich korzysta bez deklarowania minimalnej wersji, zainstaluje się w starszej przeglądarce, ale te funkcje nie zadziałają.
127–128MV2 nadal działa; Chrome zaczyna ostrzegać o końcu MV2 na stronie rozszerzeń.Zmierzone120Dostępne uprawnienie userScripts (użytkownik musi je też włączyć).Dokumentacja Chrome114Dostępny sidePanel.Zmierzone109Dostępne API offscreen; wcześniejsze wersje instalują się i działają, ale wywołania się nie udają.Zmierzonesty 2022Chrome Web Store przestaje przyjmować nowe rozszerzenia MV2 (zasada sklepu, nie zmiana w przeglądarce).Zasady sklepu96Dostępne uprawnienie declarativeNetRequestWithHostAccess.Dokumentacja Chrome92Tło oparte na modułach ES zaczyna działać.Zmierzone
MV3 trafia do wersji stabilnej
Od Chrome 88 rozszerzenia MV3 instalują się i działają. Tło napisane jako moduł ES ("type": "module") do wersji 92 wciąż się instaluje, ale nigdy nie uruchamia.
88–91Tło-moduł jest widoczne z service workerem, ale nigdy nie startuje.Zmierzone88Podstawowe MV3: instalacja, włączenie i działanie tła.Zmierzone
Lata tylko z MV2
Manifest V2 to jedyny stabilny format. Rozszerzenie MV3 instaluje się i wygląda na włączone w stabilnym Chrome, ale jego skrypt w tle nigdy się nie uruchamia — to błąd najtrudniejszy do zauważenia.
87Stabilna wersja 87 akceptuje najwyżej manifest_version 2; tło service_worker jest dostępne tylko w kanale Dev.Kod źródłowy
Od Chrome 137 MV2 jest odrzucane, a zwykli użytkownicy nie mają jak tego obejść.
Chrome 129–136 automatycznie wyłącza rozszerzenia MV2, ale użytkownicy mogą je ponownie włączyć.
MV3 wymaga Chrome 88 lub nowszego; starsze przeglądarki instalują je, ale nigdy nie uruchamiają.
Przed pobraniem starszej wersji
- Sprawdź wersję manifestu: w Chrome 137 i nowszych wybieraj tylko MV3.
- Sprawdź minimalną wersję: poniżej niej instalacja jest odrzucana.
- W starej przeglądarce wybierz najnowszą zgodną wersję albo najpierw zaktualizuj przeglądarkę.
Metoda i ograniczenia
Testy przeprowadzono 18 paź 2026 w systemie Linux na Chrome for Testing 113–156 i migawkach Chromium 87–112, z rozszerzeniami testowymi oraz prawdziwymi Google Translate 2.0.13 / 2.0.18 i AdBlock, aby odróżnić „zainstalowane”, „włączone” i „tło naprawdę działa”; instalację CRX sprawdzono wymuszoną instalacją przez zasady firmowe. Chrome for Testing nie ma stopniowych wdrożeń, więc powyższe wersje pokazują, kiedy działa kod — prawdziwi użytkownicy mogli zobaczyć zmiany później. Nie objęto testami systemów Windows i Mac, Edge ani innych przeglądarek Chromium. Daty po 150 oszacowano na podstawie czterotygodniowego cyklu wydań Chrome.
Edge i inne przeglądarki Chromium mają własne harmonogramy; nie testowano ich tutaj.