Pular para o conteúdo principal

Captcha Canvas Challenge

Nomenclatura herdada

Este pacote foi publicado originalmente no escopo @plebbit. Ele foi renomeado para @bitsocial/captcha-canvas-challenge. Referências ao nome antigo ainda podem aparecer em documentação ou bases de código mais antigas.

Captcha Canvas Challenge é um gerador de imagem captcha independente originalmente extraído de plebbit-js. Ele renderiza texto aleatório em uma tela HTML e retorna a imagem resultante, que as comunidades podem apresentar aos autores como um desafio de spam.

Código fonte: github.com/bitsocialnet/captcha-canvas-challenge

Requisitos

  • Node.js >= 22
  • Somente ESM – este pacote não envia compilações CommonJS.
  • Dependência de peer em tempo de execução: @plebbit/plebbit-js (migrando para @pkc/pkc-js)

Instalação

npm install @bitsocial/captcha-canvas-challenge

Opções de configuração

OpçãoTipoPadrãoDescrição
charactersnumber6Número de caracteres aleatórios renderizados na imagem captcha.
heightnumber100Altura da imagem gerada em pixels.
widthnumber300Largura da imagem gerada em pixels.
colorsstring#32cf7eCor primária usada para o texto captcha.

Como funciona

  1. O gerador escolhe uma string aleatória com o comprimento configurado.
  2. A string é renderizada em uma tela com ruído visual para resistir ao OCR.
  3. A imagem resultante (e a resposta esperada) são retornadas para que a aplicação chamadora possa apresentar o desafio e posteriormente verificar a resposta.

Como o pacote é um gerador de imagens puro, ele não cuida da rede ou do gerenciamento de sessões por conta própria. Pretende-se que seja integrado a um fluxo de desafio maior - por exemplo, como um dos tipos de desafio suportados pelo Spam Blocker.