Open source

FacilChrome

Extensões do Chrome com menos dor de cabeça.

Biblioteca zero-build que envolve as APIs do Chrome em Promises e organiza o código das extensões por contexto de execução.

Sobre o projeto

O que é o FacilChrome

O FacilChrome é uma biblioteca utilitária para desenvolver extensões do Chrome. Ela envolve as APIs nativas em Promises, trata erros que normalmente passariam despercebidos e organiza o código por contexto de execução, para melhorar a experiência de quem desenvolve.

É JavaScript puro com JSDoc, e o README diz que Webpack, Vite ou Babel não são necessários. Os exemplos importam o arquivo facil-chrome.js direto no projeto.

Recursos

O que o FacilChrome faz

Um namespace por contexto

As APIs ficam em Background, Content, Offscreen e Any, e o autocomplete da IDE mostra onde cada função pode ser usada.

Promises e async/await

Os callbacks nativos do Chrome viram chamadas async/await.

Erros que não passam em silêncio

O chrome.runtime.lastError vira uma exceção JavaScript comum, em vez de falhar sem avisar.

Mensagens e storage

Roteadores de mensagens assíncronas, Any.sendMessage e Any.StorageDB (com set e append).

Gravação com Offscreen

Uma abstração para o MediaRecorder em documentos Offscreen, com start, stop e download do arquivo .webm.

Sem etapa de build

JavaScript puro com JSDoc. Webpack, Vite ou Babel só se você quiser.

FAQ

Perguntas frequentes

Preciso de Webpack, Vite ou Babel?

Não. A biblioteca é JavaScript puro com JSDoc; ferramentas de build só se você quiser.

Como instalo?

O README não traz instalação por gerenciador de pacotes: os exemplos importam o arquivo local, com import { FacilChrome } from './facil-chrome.js'.

Para que serve o namespace Offscreen?

Para ambientes DOM ocultos com APIs de navegador mais pesadas, como o MediaRecorder, que o Manifest V3 não permite no background.

Qual é a licença?

MIT.

Continue explorando

Veja também

Todos os projetos