Elenco di controllo per la migrazione di Manifest V3

Monitorare l'avanzamento della migrazione

I seguenti elenchi di controllo ti aiutano a monitorare il lavoro di migrazione. Definiscono le attività che devono essere completate con i link alle istruzioni. Il lavoro di migrazione è suddiviso in cinque categorie, come descritto nel Riepilogo della migrazione.

Aggiorna il manifest

Il file manifest.json richiede un formato leggermente diverso per Manifest V3 rispetto a Manifest V2. Questa pagina descrive le modifiche che interessano solo il file manifest.json. Tuttavia, molte modifiche agli script e alle pagine richiedono anche modifiche al manifest. Queste modifiche sono coperte dalle attività di migrazione che le richiedono.

• Modifica il numero di versione del manifest.
• Aggiornare le autorizzazioni host.
• Aggiorna le risorse accessibili dal web.

Esegui la migrazione a un service worker

Un service worker sostituisce la pagina degli eventi o di background dell'estensione per garantire che il codice di background rimanga fuori dal thread principale. In questo modo, le estensioni vengono eseguite solo quando necessario, risparmiando risorse.

Prima di iniziare, leggi le differenze tra gli script di sfondo e i service worker delle estensioni.

• Aggiorna il campo "background" nel manifest
• Spostare le chiamate DOM e finestra in un documento fuori schermo
• Converti localStorage in chrome.storage.local
• Registrare i listener in modo sincrono
• Sostituisci le chiamate a XMLHttpRequest() con fetch() globale.
• Persist states
• Convertire i timer in sveglie
• Mantenere attivo il service worker (in casi eccezionali)

Aggiorna chiamate API

Alcune funzionalità devono essere sostituite con equivalenti di Manifest V3. Altri devono essere rimossi completamente.

• Sostituisci tabs.executeScript() con scripting.executeScript().
• Sostituisci tabs.insertCSS() e tabs.removeCSS() con scripting.insertCSS() e scripting.removeCSS().
• Sostituire le azioni del browser e le azioni della pagina con Azioni
• Sostituisci le funzioni che prevedono un contesto di background di Manifest V2.
• Sostituisci i callback con le promesse
• Sostituisci le API non supportate

Sostituisci i listener di richieste web di blocco

Anziché leggere e modificare le richieste di rete a livello di programmazione (come facevi in Manifest V2), la tua estensione specifica regole che descrivono le azioni da eseguire quando viene soddisfatto un determinato insieme di condizioni.

• Aggiorna autorizzazioni
• Creare regole per le richieste di rete dichiarative

Dopo aver completato i passaggi precedenti, ti consigliamo di esaminare alcuni casi d'uso comuni:

• Bloccare un singolo URL
• Redirect-multiple-urls
• Blocca cookie

Migliorare la sicurezza delle estensioni

Sono necessarie modifiche per migliorare la sicurezza delle estensioni. Ciò include la rimozione del codice ospitato in remoto, che non è più supportato.

• Rimuovere l'esecuzione di stringhe arbitrarie.
• Rimuovere il codice ospitato da remoto
• Aggiorna la policy di sicurezza dei contenuti.
• Rimuovere i valori della norma sulla sicurezza dei contenuti non supportati

Pubblica l'estensione Manifest V3

Dopo la conversione a Manifest V3, è il momento di rilasciare l'estensione sul Chrome Web Store. A seconda delle modifiche apportate, valuta un'implementazione graduale. Questo approccio ti consente di assicurarti che l'estensione funzioni come previsto con un pubblico limitato prima di renderla disponibile per l'intera base utenti.

• Pubblica una versione di test beta.
• Implementa gradualmente la release.
• Pianifica i tempi di revisione.
• Altri suggerimenti.