[FUNCIONALIDADE] Implementação de Limpeza Específica por Site

[javiergutierres951-tech]

🎯 Visão Geral da Funcionalidade

Implementar limpeza específica de dados por site para permitir que usuários limpem cache, cookies e armazenamento apenas de sites específicos.

💰 Meta de Financiamento

Meta: $30 no Buy Me a Coffee
Progresso Atual:

📅 Como acompanhar: O progresso será atualizado manualmente nesta issue conforme recebemos doações. Comentários serão adicionados a cada marco atingido!

📋 Tarefas de Implementação

Fase 1: Infraestrutura Central

• Adicionar interface de gerenciamento de sites na página de opções
• Implementar validação e análise de domínios
• Criar sistema de armazenamento de sites (favoritos/recentes)
• Adicionar novas permissões se necessário (tabs, activeTab)

Fase 2: Limpeza Específica por Site

• Implementar filtragem baseada em domínio para browsingData.remove()
• Adicionar limpeza de dados específica por origem
• Suporte para domínios curinga (*.example.com)
• Tipos de dados seletivos por site

Fase 3: UX Aprimorada

• Seletor rápido de sites no popup/menu de contexto
• Auto-sugestão de sites visitados recentemente
• Gerenciamento de sites favoritos
• Histórico de limpeza específica por site

Fase 4: Funcionalidades Avançadas

• Operações em massa de sites
• Agrupamento de sites (ambientes dev, prod, test)
• Exportar/importar listas de sites
• Estatísticas por site

🎨 Ideias de Mockup da Interface

Adição à Página de Opções:

┌─────────────────────────────────────┐
│ Limpeza Específica por Site         │
├─────────────────────────────────────┤
│ ┌─────────────────────────────────┐ │
│ │ Adicionar Site: [example.com  ] │ │
│ │                [+ Adicionar]    │ │
│ └─────────────────────────────────┘ │
│                                     │
│ Sites Favoritos:                    │
│ • github.com        [Limpar] [Edit] │
│ • localhost:3000    [Limpar] [Edit] │
│ • stackoverflow.com [Limpar] [Edit] │
│                                     │
│ ☑ Mostrar sites recentes automaticamente │
│ ☑ Habilitar domínios curinga        │
└─────────────────────────────────────┘

Adição ao Menu de Contexto:

Limpar Cache
├─ Limpar cache e recarregar página
├─ ────────────────────────────
├─ Limpar apenas este site
└─ Opções específicas por site...

🔧 Implementação Técnica

Novos Arquivos:

• js/site-manager.js - Lógica de gerenciamento de sites
• js/domain-utils.js - Utilitários de análise de domínios
• css/site-options.css - Estilização da interface específica por site

Arquivos Modificados:

• background.js - Adicionar funções de limpeza específica por site
• options/options.html - Adicionar interface de gerenciamento de sites
• options/options.js - Interações de gerenciamento de sites
• manifest.json - Adicionar permissões necessárias
• _locales/*/messages.json - Adicionar novas strings de i18n

Uso da API:

// Limpar dados para origem específica
browser.browsingData.remove({
  origins: ["https://example.com"]
}, {
  cache: true,
  cookies: true,
  localStorage: true
});

🧪 Lista de Verificação de Testes

• Validação de domínio funciona corretamente
• Domínios curinga funcionam adequadamente
• Limpeza de dados é verdadeiramente específica por site
• Interface é intuitiva e responsiva
• i18n funciona para todos os idiomas suportados
• Sem perda de dados para sites não direcionados
• Impacto na performance é mínimo

📖 Atualizações de Documentação

• Atualizar README com nova funcionalidade
• Adicionar capturas de tela à página de opções
• Atualizar explicação de permissões
• Adicionar seção de solução de problemas

🎯 Critérios de Aceitação

• Usuários podem adicionar/remover sites favoritos
• Limpeza específica por site funciona para cache, cookies, localStorage
• Interface está integrada perfeitamente com opções existentes
• Funcionalidade está totalmente internacionalizada
• Zero impacto na funcionalidade existente
• Performance permanece otimizada

---

Nota: Esta funcionalidade será implementada assim que a meta de financiamento de $30 for atingida no Buy Me a Coffee. Obrigado pelo seu apoio! 🙏

[TenSoja]

Thanks for the detailed proposal.

I actually looked into implementing something like this before, but I ran into a limitation in the Firefox WebExtension API.

The main blocker is cache handling. Firefox’s browsingData.removeCache() ignores the removal options and always clears the entire browser cache, not just the cache for a specific site:
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browsingData/removeCache

Because of that, an extension cannot reliably implement “clear data for this site only” when cache is involved. It would end up clearing the whole browser cache, which is not what users expect.

There are also other limitations around hostname/origin filtering (for example subdomains must be listed explicitly), which makes the feature even harder to implement in a clean way:
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browsingData/RemovalOptions

So while parts of this idea could work for some storage types, the complete behavior described in this issue is not possible with the current Firefox extension APIs.

If Mozilla improves the WebExtension API for site-specific data removal in the future, I’d be happy to revisit the idea.