Yhteensopivuusopas
Manifest V2 ja Manifest V3: mitä kukin Chrome-versio voi asentaa
Chrome 87:stä 156:een: seuraa versiolinjaa ja näe, milloin kumpikin laajennusmuoto toimii, milloin se lakkaa toimimasta ja mitä tarkistaa ennen vanhemman version lataamista.
Mitä Manifest V2 ja Manifest V3 ovat
- Manifest V2
- Chrome-laajennusten vanhempi muoto. Laajennukset toimivat pysyvän taustasivun avulla ja voivat siepata ja muuttaa verkkopyyntöjä suoraan. Chrome luopuu siitä.
- Manifest V3
- Nykyinen muoto, jota tuetaan Chrome 88:sta alkaen. Taustasta tulee tarvittaessa käynnistyvä service worker, verkkosuodatus käyttää deklaratiivisia sääntöjä (declarativeNetRequest) ja käyttöoikeudet ovat tiukemmat.
Jokaisen laajennuksen manifest.json kertoo, kumpaa muotoa se käyttää; alla lyhenteet MV2 ja MV3.
Manifest V2 on poissa
Selaimessa ei ole enää MV2-valitsimia eikä käytäntöjä; kaikki keinot hylätään. MV3:lla ei ole ylärajaa – se toimi versiosta 88 uusimpaan testattuun versioon 156. Ainoa jäljellä oleva riski on liian vanha selain.
156Uusin testattu versio: MV2 hylätään kaikkialla, MV3 toimii.Mitattu151Kaikki komentorivivalitsimet poistettu.Mitattu
MV2 hylätään
Tavallisille käyttäjille MV2 on ohi: asennukset hylätään eikä niitä voi ottaa uudelleen käyttöön; kehittäjätila ja ”Lataa pakkaamaton” eivät auta. Vain yrityskäytäntö (138 asti) ja komentorivivalitsimet (150 asti) pitävät sen hengissä.
150Viimeinen versio, jossa komentorivivalitsimet toimivat (ylimääräisellä uudelleen käyttöönotolla).Mitattu139Yrityskäytäntö ExtensionManifestV2Availability poistetaan.Mitattu137MV2 hylätään oletuksena; uudelleen käyttöönotto ei onnistu.Mitattu
MV2 oletuksena pois käytöstä
MV2-laajennukset asentuvat edelleen, mutta tulevat pois käytöstä (unsupportedManifestVersion). Käyttäjä voi ottaa ne uudelleen käyttöön osoitteessa chrome://extensions, ja ne toimivat normaalisti. Google otti muutoksen käyttöön vaiheittain lokakuusta 2024, joten osa käyttäjistä kohtasi sen myöhemmin.
loka 2024Google aloittaa vaiheittaisen käyttöönoton käyttäjille.Chromen ohjeet129Koodin oletusarvo alkaa poistaa MV2:n käytöstä.Mitattu
Molemmat muodot rinnakkain, MV3 täydentyy
Sekä MV2 että MV3 toimivat – sallivin vaihe. Uudet MV3-rajapinnat tulevat yksi kerrallaan; laajennus, joka käyttää niitä ilmoittamatta vähimmäisversiota, asentuu vanhempiin selaimiin, mutta ne toiminnot eivät toimi.
127–128MV2 toimii vielä; Chrome alkaa varoittaa MV2:n päättymisestä laajennussivulla.Mitattu120userScripts-oikeus saatavilla (käyttäjän on myös otettava se käyttöön).Chromen ohjeet114sidePanel saatavilla.Mitattu109offscreen-rajapinta saatavilla; aiemmat versiot asentuvat ja toimivat, mutta kutsut epäonnistuvat.Mitattutammi 2022Chrome Web Store lakkaa ottamasta vastaan uusia MV2-laajennuksia (kaupan käytäntö, ei selainmuutos).Kaupan käytäntö96declarativeNetRequestWithHostAccess-oikeus saatavilla.Chromen ohjeet92ES-moduulitaustat alkavat toimia.Mitattu
MV3 vakaaseen versioon
Chrome 88:sta alkaen MV3-laajennukset asentuvat ja toimivat. ES-moduulina ("type": "module") kirjoitettu tausta kuitenkin asentuu käynnistymättä versioon 92 asti.
88–91Moduulitausta näkyy service workerin kanssa, mutta ei koskaan käynnisty.Mitattu88Perus-MV3: asennus, käyttöönotto ja tausta toimivat.Mitattu
Pelkän MV2:n vuodet
Manifest V2 on ainoa vakaa muoto. MV3-laajennus asentuu ja näyttää käytössä olevalta vakaassa Chromessa, mutta sen taustaskripti ei koskaan käynnisty – vaikein huomattava vika.
87Vakaa 87 hyväksyy enintään manifest_version 2:n; service_worker-taustat ovat vain Dev-kanavassa.Lähdekoodi
Chrome 137:stä alkaen MV2 hylätään, eikä tavallisilla käyttäjillä ole kiertotietä.
Chrome 129–136 poistaa MV2-laajennukset automaattisesti käytöstä, mutta käyttäjät voivat ottaa ne uudelleen käyttöön.
MV3 vaatii Chrome 88:n tai uudemman; vanhemmat selaimet asentavat sen, mutta eivät koskaan käynnistä sitä.
Ennen vanhemman version lataamista
- Tarkista manifestin versio: Chrome 137:ssä ja uudemmissa valitse vain MV3.
- Tarkista vähimmäisversio: sen alapuolella asennus hylätään.
- Vanhassa selaimessa valitse uusin yhteensopiva versio tai päivitä ensin.
Menetelmä ja rajoitukset
Testattu 18.10.2026 Linuxilla Chrome for Testing 113–156:lla ja Chromium 87–112 -tilannevedoksilla, testilaajennuksilla sekä aidoilla Google Translate 2.0.13 / 2.0.18- ja AdBlock-laajennuksilla, jotta voitiin erottaa ”asennettu”, ”käytössä” ja ”tausta todella käynnissä”; CRX-asennus tarkistettiin yrityskäytännön pakotetulla asennuksella. Chrome for Testingissä ei ole vaiheittaista käyttöönottoa, joten yllä olevat versiot kertovat, milloin koodi tulee voimaan – oikeat käyttäjät ovat voineet nähdä muutokset myöhemmin. Windowsia, Macia, Edgeä ja muita Chromium-selaimia ei testattu. Version 150 jälkeiset päivämäärät on arvioitu Chromen neljän viikon julkaisurytmin perusteella.
Edge ja muut Chromium-selaimet noudattavat omia aikataulujaan; niitä ei testattu tässä.