Manifest V3-migratiechecklist

Houd de voortgang van uw migratie bij.

Opmerking: Manifest V3 wordt over het algemeen ondersteund in Chrome 88 of later. Voor extensiefuncties die zijn toegevoegd in latere Chrome-versies, raadpleegt u de API-referentiedocumentatie voor ondersteuningsinformatie. Als uw extensie een specifieke API vereist, kunt u een minimale Chrome-versie opgeven in het manifestbestand.

De volgende checklists helpen u bij het bijhouden van uw migratiewerkzaamheden. Ze beschrijven de taken die moeten worden voltooid en bevatten links naar instructies. Migratiewerkzaamheden zijn grofweg onderverdeeld in vijf categorieën, zoals beschreven in het migratieoverzicht .

Werk het manifest bij

Het manifest.json bestand vereist een iets ander formaat voor Manifest V3 dan voor Manifest V2. Deze pagina beschrijft wijzigingen die alleen van invloed zijn op het manifest.json bestand. Veel wijzigingen aan scripts en pagina's vereisen echter ook aanpassingen aan het manifest. Deze wijzigingen worden behandeld in de migratietaken die ze vereisen.

• Wijzig het versienummer van het manifest .
• Hostmachtigingen bijwerken .
• Webtoegankelijke bronnen bijwerken .

Overstappen naar een baan als servicemedewerker

Een service worker vervangt de achtergrond- of gebeurtenispagina van de extensie om ervoor te zorgen dat achtergrondcode niet op de hoofdthread wordt uitgevoerd. Hierdoor worden extensies alleen uitgevoerd wanneer dat nodig is, wat resources bespaart.

Voordat je begint, lees eerst over de verschillen tussen achtergrondscripts en extension service workers .

• Werk het veld "achtergrond" in het manifest bij.
• Verplaats DOM- en window-aanroepen naar een offscreen-document.
• Converteer localStorage naar chrome.storage.local
• Registreer luisteraars synchroon
• Vervang aanroepen naar XMLHttpRequest() door globale fetch() .
• Volhardende staten
• Zet timers om in alarmen.
• Houd de hulpverlener in leven (in uitzonderlijke gevallen).

Update API-aanroepen

Sommige functies moeten worden vervangen door equivalenten uit Manifest V3. Andere moeten volledig worden verwijderd.

• Vervang tabs.executeScript() door scripting.executeScript() .
• Vervang tabs.insertCSS() en tabs.removeCSS() door scripting.insertCSS() en scripting.removeCSS() .
• Vervang Browseracties en Pagina-acties door Acties
• Vervang functies die een Manifest V2-achtergrondcontext verwachten .
• Vervang callbacks door promises.
• Vervang niet-ondersteunde API's

Vervang blokkerende webverzoeklisteners.

In plaats van programmatisch netwerkverzoeken te lezen en te wijzigen (zoals u deed in Manifest V2), specificeert uw extensie regels die acties beschrijven die moeten worden uitgevoerd wanneer aan een bepaalde reeks voorwaarden wordt voldaan.

• Machtigingen bijwerken
• Maak declaratieve netwerkverzoekregels aan.

Nadat u bovenstaande stappen hebt voltooid, kunt u een aantal veelvoorkomende gebruiksscenario's bekijken:

• Blokkeer één enkele URL
• Doorverwijzing van meerdere URL's
• Blokkeer cookies

Verbeter de beveiliging van extensies

Er zijn wijzigingen nodig om de beveiliging van extensies te verbeteren. Dit houdt onder meer in dat code die op afstand wordt gehost, wordt verwijderd, aangezien deze niet langer wordt ondersteund.

• Voorkom de uitvoering van willekeurige tekenreeksen .
• Verwijder extern gehoste code
• Update het contentbeveiligingsbeleid .
• Verwijder niet-ondersteunde waarden voor het inhoudsbeveiligingsbeleid.

Publiceer je Manifest V3-extensie

Na de overstap naar Manifest versie 3 is het tijd om je extensie in de Chrome Web Store te publiceren. Afhankelijk van de aangebrachte wijzigingen kun je een stapsgewijze uitrol overwegen. Met deze aanpak kun je er eerst voor zorgen dat je extensie naar behoren werkt bij een beperkt aantal gebruikers, voordat je deze voor iedereen beschikbaar stelt.

• Publiceer een bètaversie .
• Voer je release geleidelijk uit .
• Plan de evaluatietijden in .
• Extra tips .