🆔 Preencher CPF - Extensão do Chrome

Uma extensão simples e prática para o Google Chrome que permite gerar e preencher automaticamente campos de formulário com CPFs válidos através do menu de contexto (clique direito).

📋 Sobre o Projeto

Esta extensão foi desenvolvida para facilitar o preenchimento de campos CPF durante testes de desenvolvimento web, permitindo gerar CPFs válidos algoritmicamente sem precisar procurar ou memorizar números.

✨ Funcionalidades

• 🎯 Menu de contexto inteligente: Aparece apenas quando você clica com o botão direito em campos editáveis
• ✅ CPFs sempre válidos: Gera CPFs que passam na validação dos dígitos verificadores

🖼️ Como Usar

1. Acesse qualquer página web com campos de CPF
2. Clique com o botão direito no campo que deseja preencher
3. Selecione "Preencher input com CPF" no menu de contexto
4. O campo será preenchido automaticamente com um CPF válido

🚀 Instalação

Instalação Local (Desenvolvedor)

1. Clone ou baixe este repositório

   git clone https://github.com/Gusstavo/CPF-extension.git
   cd CPF-extension

2. Abra o Chrome e vá para as extensões

   • Digite chrome://extensions/ na barra de endereços
   • Ou vá em Menu → Mais ferramentas → Extensões

3. Ative o modo desenvolvedor

   • No canto superior direito, ative o botão "Modo do desenvolvedor"

4. Carregue a extensão

   • Clique em "Carregar sem compactação"
   • Selecione a pasta do projeto
   • A extensão será instalada e ativada automaticamente

🔧 Estrutura do Projeto

cpf-extension/
├── manifest.json      # Configurações da extensão
├── background.js      # Service worker (menu de contexto)
├── content.js         # Script de conteúdo (lógica principal)
├── README.md         # Este arquivo
├── image.png         # Screenshot de exemplo
└── icons/            # Ícones da extensão
    ├── 16.png
    ├── 32.png
    ├── 48.png
    └── 128.png

🛠️ Detalhes Técnicos

Algoritmo de CPF

• Gera 9 dígitos aleatórios
• Calcula os 2 dígitos verificadores usando o algoritmo oficial
• Resultado: CPF sempre válido matematicamente

Formatação Inteligente

• Campos tipo "number": Apenas dígitos (12345678901)
• Outros campos: Formatado (123.456.789-01)
• contenteditable: Suporte completo

Compatibilidade com Frameworks

A extensão dispara os eventos necessários para que bibliotecas como React, Vue e Angular detectem as mudanças:

• input event (bubbles: true)
• change event (bubbles: true)

🔒 Permissões

A extensão solicita as seguintes permissões:

• contextMenus: Para criar o menu de contexto
• scripting: Para injetar scripts nas páginas
• activeTab: Para acessar a aba ativa
• host_permissions: Para funcionar em todos os sites

⚠️ Aviso Legal

Esta extensão foi criada para fins de desenvolvimento e testes. Os CPFs gerados são válidos matematicamente, mas fictícios. Não utilize CPFs gerados para fins fraudulentos ou ilegais.

---

Desenvolvido com ❤️ para facilitar o trabalho de desenvolvedores web