Ferramenta de compartilhamento de texto (Paste Bin)

Uma ferramenta de compartilhamento de texto, frequentemente chamada de paste bin, é uma página da web para publicar um bloco de texto ou código e obter um link que mostra esse texto a qualquer pessoa que o abra. Esta ferramenta de paste bin funciona inteiramente no navegador, não exige uma conta e pode adicionar realce de sintaxe opcional e um prazo de validade ao link.

Como funciona a ferramenta de compartilhamento de texto

A maioria dos serviços de paste bin armazena o texto em um servidor e devolve um link curto que aponta para uma linha de um banco de dados. Esta ferramenta funciona de modo diferente. Ela não tem servidor nem banco de dados. Em vez disso, coloca todo o conteúdo colado no próprio link.

Quando alguém clica em “Criar link”, a ferramenta faz quatro coisas:

1. Ela cria um pequeno objeto que contém o texto, a linguagem escolhida e o prazo de validade (ou nada, para “nunca”).
2. Ela converte esse objeto em uma linha de texto JSON.
3. Ela transforma o JSON em bytes, usando a codificação UTF-8 que a web utiliza em toda parte.
4. Ela codifica esses bytes como base64url, um esquema que transforma bytes arbitrários em letras, dígitos, - e _, para que o resultado seja seguro dentro de uma URL.

O texto codificado é colocado depois de #p= no final da URL da página. Tudo depois de # é chamado de fragmento. Um navegador nunca envia o fragmento a um servidor ao carregar uma página, portanto o conteúdo colado nunca é transmitido para lugar algum. Ler o link de volta é o mesmo processo no sentido inverso: decodificar o texto base64url, transformar os bytes novamente em uma string JSON com UTF-8 e analisar o JSON para recuperar o texto, a linguagem e o prazo de validade.

Como o fragmento contém todo o conteúdo colado, um link de compartilhamento funciona em qualquer dispositivo ou navegador, não apenas naquele que o criou. Nada precisa ser consultado. Abrir o link basta para exibir o conteúdo, assim como abrir um arquivo baixado não exige perguntar a um servidor o que o arquivo contém.

A ferramenta também mantém uma cópia local de cada conteúdo colado no armazenamento do navegador, como rascunho de conveniência. Essa cópia só ajuda o mesmo navegador a encontrar novamente seus próprios conteúdos colados anteriormente; ela não participa da abertura de um link compartilhado, e apagá-la não invalida nenhum link de compartilhamento, porque o link nunca dependeu dela.

Realce de sintaxe

O realce de sintaxe colore partes do código, como palavras-chave, strings e comentários, para facilitar a leitura da estrutura. A ferramenta oferece dez opções:

• Texto simples (sem realce)
• JavaScript
• TypeScript
• Python
• Java
• HTML
• CSS
• JSON
• SQL
• Bash

A linguagem escolhida é armazenada dentro da carga codificada, portanto o realce é aplicado automaticamente quando o link é aberto, sem que o leitor precise escolher nada.

Fórmula do prazo de validade

Uma opção de prazo de validade define um registro de data e hora absoluto, medido em milissegundos desde 1 de janeiro de 1970 (um ponto de referência comum na computação chamado época Unix). A ferramenta adiciona um período fixo ao momento em que o link é criado:

Por exemplo, se um link for criado quando o relógio marcar 1.700.000.000.000 ms e o criador escolher “1 semana”, o prazo de validade armazenado será:

1.700.000.000.000 + (7 × 24 × 60 × 60 × 1.000) = 1.700.604.800.000 ms

Quando um leitor abre o link, a ferramenta compara esse registro de data e hora armazenado com a hora atual. Se o horário armazenado já tiver passado, a ferramenta exibe a mensagem “Este conteúdo expirou” em vez do texto. Como o registro de data e hora do vencimento viaja dentro do link junto com o texto, essa verificação funciona da mesma maneira em qualquer dispositivo.

Exemplo prático: como um conteúdo colado se torna um link

Suponha que alguém compartilhe o texto simples Hello, world! sem prazo de validade. A ferramenta cria este objeto JSON, usando nomes curtos de campos para manter o link compacto:

Ela codifica esse JSON como bytes UTF-8 e depois como base64url, produzindo:

O link completo de compartilhamento é o endereço da página mais esse token depois de #p=:

Quem abrir esse link terá um navegador que decodifica o token, lê Hello, world! de volta como texto simples e o exibe. Nenhum servidor foi consultado.

Como compartilhar texto ou código

1. Digite ou cole o texto na caixa de texto. A contagem de caracteres é atualizada enquanto o texto é digitado.
2. Opcionalmente, escolha uma linguagem no menu de realce de sintaxe.
3. Opcionalmente, escolha por quanto tempo o link deverá permanecer válido.
4. Clique em “Criar link”.
5. Copie o link gerado com o botão “Copiar link” e envie-o da maneira preferida.

Como visualizar texto compartilhado

1. Abra o link compartilhado.
2. O texto aparece imediatamente, com realce se uma linguagem tiver sido escolhida.
3. Use “Copiar texto” para copiar o conteúdo para a área de transferência.
4. Use “Criar novo” para iniciar um novo conteúdo colado.

Um conteúdo colado não pode ser editado depois que o link é criado. Alterar o texto exige criar um novo conteúdo e compartilhar o novo link.

Usos comuns

• Desenvolvedores que compartilham um trecho de código para revisão ou ajuda na depuração.
• Professores que compartilham código inicial ou instruções.
• Qualquer pessoa que transfira um bloco de texto, como uma lista ou um conjunto de anotações, entre dois dispositivos próprios.

Para textos que precisam permanecer editáveis por várias pessoas ao mesmo tempo, uma ferramenta de documento compartilhado é mais adequada. Para códigos que precisam de um histórico permanente, um sistema de controle de versão, como o Git, é mais adequado.

Limites e privacidade

Como todo o conteúdo colado fica dentro do link, o limite prático é o comprimento da própria URL, não uma cota de armazenamento. Os navegadores conseguem lidar com URLs longas, mas muitos programas de e-mail, aplicativos de bate-papo e sistemas antigos truncam ou rejeitam URLs muito longas; por isso, conteúdos colados extremamente grandes podem não ser transmitidos bem por todos os canais. Conteúdos curtos e médios não são afetados.

O fragmento nunca é enviado a um servidor, portanto a própria ferramenta nunca sabe o que foi colado. Qualquer pessoa que tenha o link exato pode abri-lo, então um link deve ser tratado da mesma forma que o texto que contém: não compartilhe senhas nem outros dados confidenciais dessa maneira e não publique o link em um local público se o conteúdo precisar permanecer privado.

Dúvidas frequentes

Onde o texto compartilhado fica realmente armazenado? Ele não fica armazenado em nenhum lugar separado do link. O texto, a linguagem escolhida e o prazo de validade são codificados diretamente no fragmento do link, a parte depois de #. O próprio link é a única cópia.

O link funciona em outro dispositivo ou navegador? Sim. Como o conteúdo viaja dentro do link, qualquer dispositivo que o abra pode decodificar e exibir o conteúdo. Não é necessária uma conta nem o navegador original.

O que acontece se eu limpar os dados do navegador? Nada acontece com os links de compartilhamento existentes. Eles não dependem de nada armazenado no navegador, apenas do próprio link. Limpar os dados do navegador apenas remove a cópia local de conveniência que o navegador mantém dos conteúdos criados naquele dispositivo.

Posso editar um conteúdo colado depois de criar o link? Não. É preciso criar um novo link para qualquer alteração, pois o conteúdo é incorporado ao link no momento de sua criação.

O que acontece quando um conteúdo colado expira? Abrir um link expirado exibe uma mensagem informando que o conteúdo expirou, em vez do texto original. O link continua existindo; ele simplesmente deixa de exibir o conteúdo quando o registro de data e hora do vencimento armazenado já passou.

Existe um limite de tamanho? Não há um limite fixo de armazenamento, mas URLs muito longas podem ser rejeitadas ou truncadas por alguns clientes de e-mail e aplicativos de mensagens; por isso, conteúdos colados muito grandes são mais adequados para uma ferramenta dedicada de compartilhamento de arquivos.

Referências

1. "UTF-8." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/UTF-8
2. "Base64." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/Base64
3. "URL." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/API/URL
4. "Syntax highlighting." Wikipédia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Syntax_highlighting
5. "Unix time." Wikipédia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Unix_time