O Chrome eliminou o Manifest V2 silenciosamente. Um dia, a Web Store parou de aceitar envios de MV2. Se você criar extensões de navegador como parte de sua pilha de produtos independentes, esse prazo já passou.Manifesto V3não é mais opcional. É o único jogo da cidade.

A questão não é se devemos adotar o MV3. A questão é como repensar sua arquitetura para parar de lutar contra a plataforma e começar a trabalhar com ela. Essa mudança é maior do que a maioria dos tutoriais admite.

Por que MV3 parece um tempo de execução diferente

Pense nos scripts de segundo plano do MV2 como um servidor que nunca dorme. Suas variáveis viviam lá permanentemente. Seus cronômetros funcionaram de forma confiável. O estado estava sempre aquecido e pronto.

MV3 substitui isso por umTrabalhador de serviço. Service Workers são projetados para serem efêmeros. O Chrome pode encerrá-los sempre que houver pressão na memória e acordá-los para o próximo evento. Não há garantia de que seu trabalhador esteja ativo entre duas ativações de guias.

Isso não é um bug. É o design. O Chrome fez essa troca para reduzir a superfície de ataque de extensões maliciosas. Se você concorda com essa compensação, não importa. Sua arquitetura deve levar em conta isso.

A implicação mais profunda: qualquer coisa que você armazenou em uma variável dentro do seu script de segundo plano agora é mortal. Você precisa de uma camada de persistência externa.armazenamento cromadotorna-se sua única fonte de verdade, não uma API conveniente.

O problema de armazenamento é maior do que você pensa

chrome.storage.local tem limite de 10 MB por padrão. Para extensões simples que armazenam preferências, isso é suficiente. Para extensões que armazenam em cache respostas da API, rastreiam o comportamento do usuário ou armazenam conteúdo de documentos, 10 MB evaporam rapidamente.

A solução que a maioria dos desenvolvedores ignora éBanco de dados indexado. Ele reside no navegador, lida com gigabytes de dados e oferece suporte a transações. É acessível a partir de Service Workers, páginas pop-up e scripts de conteúdo. No entanto, o acesso do Service Worker ao IndexedDB apresentava bugs de confiabilidade em versões mais antigas do Chrome. Almeje o Chrome 102 ou superior se você seguir esse caminho.

Aqui está uma configuração mínima do IndexedDB que funciona de maneira confiável em MV3 Service Workers:

// storage.js, funciona em scripts SW, pop-up e conteúdo
const DB_NAME = 'MyExtensionDB';
const DB_VERSION = 1;

função de exportação openDatabase() {
  retornar nova Promessa((resolver, rejeitar) => {
    const req = indexedDB.open(DB_NAME, DB_VERSION);

    req.onupgradeneeded = (evento) => {
      const banco de dados = evento.target.result;
      if (!db.objectStoreNames.contains('cache')) {
        const store = db.createObjectStore('cache', { keyPath: 'key' });
        store.createIndex('timestamp', 'timestamp', {único: falso });
      }
    };

    req.onsuccess = (evento) => resolver(event.target.result);
    req.onerror = (evento) => rejeitar (event.target.error);
  });
}

exportar função assíncrona saveRecord(chave, dados) {
  const db = aguarda openDatabase();
  retornar nova Promessa((resolver, rejeitar) => {
    const tx = db.transaction('cache', 'readwrite');
    tx.objectStore('cache').put({chave, dados, carimbo de data/hora: Date.now() });
    tx.oncomplete = resolver;
    tx.onerror = rejeitar;
  });
}

Esse padrão oferece recuperação de falhas gratuitamente. Se o Chrome encerrar seu Service Worker no meio da sessão, os dados sobreviverão. Quando o SW é reiniciado, ele lê o IndexedDB e retoma de forma limpa.

Os temporizadores não são o que eram

Os desenvolvedores individuais geralmente criam extensões que precisam funcionar dentro de um cronograma. Pense em rastreadores de custos, ferramentas de lembrete ou utilitários de sincronização. No MV2, você jogou umsetIntervalem seu script de segundo plano e esqueci disso.

No MV3, essa abordagem é interrompida. O Chrome pode encerrar seu Service Worker antes que o próximo intervalo seja acionado. Você obtém lacunas. Você recebe atualizações perdidas. Você fica com usuários frustrados preenchendo relatórios de bugs.

A substituição échrome.alarms. Os alarmes persistem durante as reinicializações do Service Worker. O Chrome ativa seu SW especificamente para lidar com cada evento de alarme. A limitação é de um período mínimo de um minuto. Você não pode disparar um alarme a cada cinco segundos.

Para atualizações sub-minutos, o padrão certo é uma abordagem dividida. Sua página pop-up funciona por conta própriasetIntervalenquanto estiver aberto, porque as páginas pop-up têm um ciclo de vida estável enquanto visíveis. O alarme trata da persistência quando o pop-up é fechado. Isso cobre tanto o caso de exibição em tempo real quanto o caso de persistência em segundo plano sem hacks.

Requisitos de segurança que o pegarão desprevenido

MV3 apertou oPolítica de segurança de conteúdosignificativamente. Dois padrões que funcionaram no MV2 interromperão a revisão da extensão ou causarão erros de tempo de execução.

Sem execução remota de script

Se a sua extensão buscou um script de um CDN e o executou dinamicamente, isso acabou. Todo o JavaScript deve ser fornecido com sua extensão no momento do envio. Isso afeta extensões que carregam bibliotecas de gráficos, scripts analíticos ou código utilitário de URLs externos.

A correção é simples: agrupe tudo localmente usando uma ferramenta de construção comoconstruçãoou acumulação. Você ganha um pacote menor, mais rápido e auditável. Você perde a capacidade de enviar atualizações JS sem um novo envio para a Loja. Planeje sua cadência de lançamento de acordo.

innerHTML é uma responsabilidade

MV3 não proíbeHTML internoabertamente. No entanto, usá-lo com qualquer conteúdo fornecido pelo usuário ou obtido pela API cria um vetor XSS que os revisores sinalizarão. O CSP mais rígido torna a exploração mais difícil, mas a atitude certa é parar de usar o innerHTML inteiramente para conteúdo dinâmico.

Mude para métodos de criação de DOM. Usardocumento.createElementetextoConteúdopara quaisquer dados que você não controle totalmente. Isso também torna sua extensão mais fácil de auditar, o que acelera as revisões da Web Store.

Quanto MV3 realmente custa para desenvolvedores solo

Sejamos honestos sobre as compensações aqui. A migração MV3 não é gratuita. Aqui está o que você está pagando:

Mais código assíncrono:Cada leitura de estado atinge o armazenamento. Você escreve mais chamadas de espera. Mais tratamento de erros. Mais sobrecarga cognitiva.
Ciclos de revisão mais longos:Um CSP mais rigoroso significa mais escrutínio do revisor. Reserve um tempo extra para seu primeiro envio de MV3.
Limites de granularidade de alarme:O mínimo de um minuto mata completamente certas ideias de produtos. Verificadores de preços em segundo plano, rastreadores em tempo real e recursos de pulsação precisam ser redesenhados.
Disciplina de pacote:Nenhum script remoto significa que seu pipeline de construção é importante. Você precisa de um empacotador adequado, caso ainda não o tenha feito.
Complexidade do IndexedDB:A API baseada em Promise é detalhada. Embrulhe-o cedo ou use uma biblioteca fina comouma abstração de armazenamento bem documentadapara padrões de referência.

Além disso, a abordagem assíncrona forçada em todos os lugares muda a forma como você testa. Os testes de unidade que dependiam de leituras de estado síncronas precisam ser reescritos. Considere isso em sua estimativa de migração.

O que MV3 oferece em troca

As restrições têm benefícios reais. O modelo async-first significa que sua extensão lida com reinicializações e travamentos do navegador normalmente por padrão. Os usuários não perdem o estado quando o Chrome é atualizado. Sua extensão se comporta de maneira previsível entre sessões.

O reforço da segurança também ajuda na confiança. Os usuários estão cada vez mais desconfiados das extensões após anos de histórias de malware. Uma extensão construída em MV3 com um pacote limpo e auditável é mais fácil de explicar para usuários céticos. Se você promover sua extensão publicamente, esse sinal de confiança é importante. UMferramenta gratuita de auditoria de mídia socialpode ajudá-lo a avaliar se o marketing da sua extensão está transmitindo os sinais de credibilidade corretos em todas as plataformas.

Além disso, a disciplina de agrupamento forçado muitas vezes produz extensões menores e mais rápidas. O carregamento lento é substituído pela divisão deliberada do código. O desempenho melhora como efeito colateral das restrições.

Etapas práticas para sua próxima construção de extensão

Se você está iniciando uma nova extensão hoje ou planejando uma migração, aqui está uma lista de verificação concreta:

Audite cada estado que sua extensão precisa. Decida o que vai em chrome.storage.local, o que vai em IndexedDB e o que pode ser derivado sob demanda.
Substitua todas as chamadas setInterval em segundo plano por chrome.alarms. Redesenhe qualquer recurso que precisasse de atualizações em segundo plano em menos de um minuto.
Agrupe todas as dependências localmente. Configure esbuild ou Rollup antes de escrever sua primeira linha de código de extensão.
Substitua o uso de innerHTML por métodos DOM em todos os arquivos que lidam com dados externos.
Escreva uma função auxiliar do openDB uma vez e importe-a para qualquer lugar. Não reescreva a configuração do IndexedDB em cada módulo.
Teste a rescisão do Service Worker explicitamente. Use o Chrome DevTools para interromper manualmente seu SW e verificar se sua extensão se recupera corretamente.

Orecursos de aprendizagem web.devabordaremos detalhadamente o ciclo de vida do Service Worker. Ler essa documentação antes de arquitetar sua lógica de segundo plano economizará horas de depuração mais tarde.

Ferramentas que se adaptam a um fluxo de trabalho MV3

Os desenvolvedores individuais que criam extensões geralmente usam todos os tipos de funções. Você escreve o código, projeta a IU e cuida do marketing. Manter seu conjunto de ferramentas enxuto é importante.

Para compartilhar sua extensão durante o teste beta, umgerador de código QR gratuitopermite criar links que podem ser escaneados para sua listagem da Chrome Web Store sem configuração extra. Útil para demonstrações presenciais ou cabines de conferência.

Se sua extensão captura capturas de tela ou processa imagens, umRemovedor de fundo AIajuda você a criar ativos promocionais limpos para a listagem da Web Store rapidamente.

Antes de lançar, execute a página de destino da sua extensão por meio de umavaliador de sites grátispara detectar problemas de SEO e desempenho que podem prejudicar a descoberta orgânica.

Se a sua extensão processa arquivos de mídia de alguma forma, é importante entender como os formatos funcionam. UMconversor de vídeo para MP3 grátisé um bom ponto de referência para pensar sobre como os pipelines de processamento de arquivos baseados em navegador se comportam.

A acessibilidade da UI da sua extensão também é importante. OProjeto A11Ypossui listas de verificação práticas para tornar páginas pop-up e scripts de conteúdo utilizáveis para todos. Esta é uma área que o MV3 não aborda diretamente, mas os revisores da Web Store notam problemas de acessibilidade.

O resultado final para construtores de extensões independentes

Manifesto V3é uma plataforma mais difícil de construir do que MV2. Os requisitos assíncronos, limites de armazenamento e restrições de temporizador criam atritos reais. No entanto, as restrições também levam você a um código mais resiliente e auditável.

Os desenvolvedores que terão mais dificuldades são aqueles que tentam portar padrões MV2 diretamente. Os desenvolvedores que prosperarão serão aqueles que aceitarem as novas restrições como entradas de design e repensarem sua arquitetura desde o início.

A troca vale a pena? Para a maioria dos projetos de extensão independentes, sim. A Web Store ainda é um canal de distribuição viável. A base de usuários é enorme. As opções de monetização são reais. Você só precisa construir de forma diferente agora.

Comece com seu modelo de estado. Faça isso direito e o resto da sua extensão MV3 se encaixará. Se errar, você passará semanas depurando casos extremos de encerramento do Service Worker que parecem bugs aleatórios.

Esta postagem contém links afiliados. Se você fizer uma compra por meio desses links, poderemos ganhar uma comissão sem nenhum custo adicional para você.