1. Início
  2. Tutoriais
  3. Instalar a extensão

Tutorial — instalação

A extensão para baixar SVG, instalada e funcionando

Uma instalação, uma fixada, e uma resposta direta sobre o que ela consegue ver. Essa última parte é a que vale ler — uma extensão capaz de ler páginas merece o escrutínio.

Assista — 17 segundos

Da instalação ao primeiro download

tutorial · instalação
Fixe uma vez e o botão fica onde você espera em toda página depois disso.

Fixar é o passo que as pessoas pulam e depois se perguntam para onde foi o botão — o Chrome esconde extensões novas atrás do ícone da peça de quebra-cabeça por padrão.

O que a gravação mostra

  1. Instale uma vez pela Chrome Web Store
  2. Fixe, e então clique nela em qualquer página
  3. Ela pede activeTab — esta página, este clique, nada mais
  4. Chrome, Edge e Brave rodam ela
  5. E funciona igual nos três

Instalação

Instalando no Chrome, Edge ou Brave

Os três rodam Chromium, então é uma extensão e um fluxo de instalação só. Qualquer coisa no Chrome 88 ou mais novo funciona.

  • Chrome. Abra a ficha da Chrome Web Store e escolha Usar no Chrome, depois confirme.
  • Edge. A mesma ficha. O Edge vai pedir para permitir extensões de outras lojas na primeira vez; concorde e instale normalmente.
  • Brave. A mesma ficha, sem passo extra — o Brave instala direto da Chrome Web Store.

Depois fixe, que é o passo que realmente importa no dia a dia: clique no ícone da peça de quebra-cabeça na barra de ferramentas, ache o SVG Downloader e clique no alfinete. Sem isso, o Chrome guarda ela e você vai clicar na peça de quebra-cabeça toda santa vez.

Instalação e primeira rodada

Cerca de quarenta segundos, a maior parte disso é a página da loja carregando.

  1. Instale pela Chrome Web Store. Escolha Usar no Chrome — ou Edge, ou Brave — e confirme o aviso de permissões.
  2. Fixe na barra de ferramentas. Clique no ícone da peça de quebra-cabeça, ache o SVG Downloader, clique no alfinete. O botão agora fica na sua barra permanentemente.
  3. Abra uma página com vetores e clique no botão. O popup abre e escaneia aquela aba. Nada estava vigiando a página antes do seu clique.
  4. Baixe um para confirmar que funciona. Percorra até qualquer ícone, aperte Baixar o atual, e confira sua pasta de downloads. Instalação verificada.

O que cada permissão realmente permite

Cinco permissões, e nenhuma delas é a permissão ampla com que as pessoas se preocupam.

  • activeTab — ela consegue ler a página da aba em que você está, no momento em que você clica no botão dela, e não antes nem depois. Essa é a importante: não há permissão de host, então ela não recebe acesso a “todos os seus dados em todos os sites” e não está rodando quietinha em segundo plano em toda página que você visita.
  • downloads — grava arquivos na sua pasta de downloads. Inevitável para um baixador.
  • contextMenus — adiciona o item “Salvar isto como SVG” ao menu do botão direito.
  • scripting — injeta o código que lê a página, sob demanda, depois que você já clicou.
  • storage — guarda suas configurações (prefixo do nome, nome do ZIP) localmente na sua máquina.

Além disso, a política de segurança de conteúdo da extensão define connect-src 'none', o que proíbe estruturalmente as páginas dela de abrir uma conexão de rede. Não é uma promessa de não ligar para casa; é uma configuração sob a qual ligar para casa não funciona. E como ela é licenciada MIT com código público, nada disso precisa ser aceito por fé.

Páginas em que ela não vai rodar

Os navegadores bloqueiam extensões nas próprias páginas, e extensão nenhuma passa por cima disso: páginas de configuração chrome:// e edge://, a Chrome Web Store e outras galerias de complementos, e documentos PDF. Nessas, o popup vai te dizer que não consegue acessar a página em vez de falhar em silêncio. Para páginas locais file:// você pode conceder acesso a arquivos explicitamente nos detalhes da extensão, se precisar.

Firefox e Safari

No momento não. Esta é uma extensão Chromium Manifest V3; Firefox e Safari precisam cada um do próprio port e da própria revisão de loja, o que não foi feito.

Navegadores
Chrome 88+, Edge e Brave. Firefox e Safari não.
Permissão-chave
activeTab — esta aba, no seu clique. Sem permissão de host.
Rede
connect-src 'none' — ela estruturalmente não consegue ligar para casa.
Código
Licença MIT no GitHub. Leia ou compile você mesmo.

Vale saber

Perguntas frequentes

Em quais navegadores funciona?

Chrome 88 ou mais novo, Edge e Brave — todos baseados em Chromium, uma instalação da mesma ficha da loja. Não existe versão para Firefox ou Safari.

Para onde foi o botão depois que instalei?

O Chrome esconde extensões novas atrás do ícone da peça de quebra-cabeça. Clique nele, ache o SVG Downloader e clique no alfinete para mantê-lo na barra de ferramentas.

Ela consegue ler toda página que eu visito?

Não. Ela usa activeTab, que dá acesso à aba atual só no momento em que você clica no botão dela. Não há permissão de host, então ela não está rodando em segundo plano em outras páginas.

Ela envia algo para um servidor?

Ela não consegue. A política de segurança de conteúdo dela define connect-src como none, o que proíbe as páginas dela de abrir qualquer conexão de rede. O código é público se você quiser verificar.

Por que o popup diz que não consegue acessar esta página?

Você está numa página em que os navegadores bloqueiam extensões — uma página de configuração chrome://, a Chrome Web Store ou outra galeria de complementos, ou um PDF. Essa restrição é imposta pelo navegador e não pode ser contornada.


Instale, fixe, esqueça

Menos de um minuto, e ela só acorda quando você clica.