Escape de JSON

O que é o Escape de JSON?

// Input text
She said "hi"
then left.

// Escaped (Wrap on) — identical to JSON.stringify(input)
"She said \"hi\"\nthen left."

// Escaped (Wrap off) — just the body, for hand-built JSON
She said \"hi\"\nthen left.

// JSON-in-JSON
{"a":1}  ->  "{\"a\":1}"  ->  {"payload": "{\"a\":1}"}

Principais Recursos

Exemplos

{"event":"signup","user":{"id":42,"name":"Alice"}}

function greet(name) {
  return `Hello, ${name}!`;
}

She said "hello"	then left.

Price: 9.99€ — café société

Como Usar

1. 1

   Cole seu texto ou JSON

   Digite ou cole qualquer coisa no campo de entrada — um objeto JSON, um trecho de código, uma linha de log ou texto comum. O resultado com escape aparece instantaneamente. Clique em 'Carregar exemplo' para testar uma amostra, como um payload JSON-in-JSON ou uma função multilinha.

2. 2

   Escolha as opções de escape

   Mantenha 'Envolver em aspas duplas' ativada para um literal de string JSON completo (igual a JSON.stringify), ou desativada para obter apenas o corpo com escape. Alterne 'Escape de não-ASCII' para saída \uXXXX em ASCII puro, e 'Escape da barra' ao inserir JSON em uma tag HTML <script>.

3. 3

   Copie a string com escape

   Clique em Copiar para pegar o resultado, pronto para colar em um documento JSON, corpo de requisição REST ou arquivo de configuração. Clique em Trocar direção para virar para o modo de des-escape e verificar uma ida e volta sem perdas.

Armadilhas Comuns de Escape

Input already escaped: line1\nline2
Escaped again -> line1\\nline2  (literal backslash-n)

Raw input: line1
line2
Escaped once -> line1\nline2  (real newline encoded)

{"msg": hello \"world\"}
// Missing quotes around the value -> invalid JSON

{"msg": "hello \"world\""}
// Wrap on supplies the quotes -> valid JSON

café  ->  caf\u00e9   (no downstream need; just noise)

café  ->  café         (valid JSON, readable, smaller)

Casos de Uso Comuns

Payloads de Webhook JSON-in-JSON

Faça o escape de um corpo de requisição para que ele possa ser armazenado como um campo de string dentro de um envelope de webhook, mensagem Kafka ou log de auditoria. Mantenha Envolver ativado e a saída fica pronta para atribuir a uma chave no documento externo.

Trechos Multilinha em Configuração

Transforme um script de shell multilinha, consulta SQL ou trecho de código em um único valor de string JSON. Cada quebra de linha vira \n para que o arquivo de configuração JSON permaneça válido em uma única linha.

Corpos de Requisição REST Montados à Mão

Faça o escape de uma string JSON antes de inseri-la em um argumento curl --data ou em um cliente HTTP, para que aspas e quebras de linha sobrevivam ao shell e à rede sem quebrar a requisição.

Codificação de Strings Segura para Logs

Faça o escape de conteúdo fornecido pelo usuário antes de gravá-lo em uma linha de log estruturada, impedindo que aspas ou quebras de linha injetadas corrompam o formato do log ou um parser de log JSON posterior.

Integrações Legadas Somente em ASCII

Produza saída \uXXXX em ASCII puro para gateways SOAP, cabeçalhos de e-mail ou sistemas mais antigos que corrompem UTF-8 em trânsito, permanecendo totalmente decodificável por qualquer parser JSON moderno.

Inserir JSON em HTML

Faça o escape de barras para que um bloco JSON possa ser embutido diretamente dentro de uma tag <script> em páginas renderizadas no servidor, sem que </script> dentro dos dados feche a tag cedo demais.

Detalhes Técnicos

Algoritmo de Escape

A ferramenta serializa sua entrada com as regras de string da especificação JSON: U+0022 (") → \", U+005C (\) → \\, U+0008 → \b, U+000C → \f, U+000A → \n, U+000D → \r, U+0009 → \t, e qualquer outro caractere abaixo de U+0020 → \u00XX. Com Envolver ativado, as aspas duplas ao redor são incluídas; com ela desativada, são removidas. Isso corresponde exatamente à saída de um serializador conforme, garantindo idas e voltas sem perdas.

Unicode e Pares Substitutos

Por padrão, os caracteres acima de U+007F são emitidos como UTF-8 literal, o que o JSON permite. Com Escape de não-ASCII ativado, cada caractere desse tipo é convertido em \uXXXX usando sua unidade de código UTF-16; caracteres fora do Plano Multilíngue Básico (emojis, escritas raras) são codificados como um par substituto de dois escapes \uXXXX — por exemplo 😀 (U+1F600) vira \ud83d\ude00, a mesma representação que um serializador JSON produz.

Barra e Contexto HTML

O JSON não exige escape de /, então ela é preservada por padrão. Quando Escape da barra está ativado, cada / vira \/. A única razão prática para isso é a inserção em HTML: dentro de uma tag <script>, a substring literal </script> fecha a tag independentemente do contexto JSON, então fazer o escape da barra para <\/script> mantém o JSON inserido intacto enquanto permanece válido pela especificação.

Boas Práticas

Mantenha Envolver Ativado para Literais Completos

Quando você precisa de um valor para atribuir em código ou colar após os dois-pontos em JSON, mantenha Envolver em aspas duplas ativado — a saída é uma string JSON completa e analisável, idêntica a JSON.stringify. Desative-a apenas quando você mesmo estiver digitando as aspas ao redor.

Deixe o Escape de Unicode Desativado a Menos que Necessário

UTF-8 bruto é JSON válido e muito mais legível. Ative Escape de não-ASCII apenas para um sistema posterior específico que trate mal UTF-8 (SOAP legado, alguns pipelines de log, arquivos-fonte somente em ASCII). Fazer o escape de tudo por padrão só deixa a saída mais ruidosa.

Só Faça o Escape de Barras para Inserção em HTML

O escape da barra importa em exatamente um lugar: JSON inserido em uma tag HTML <script>. Fora desse contexto, ele adiciona desordem sem benefício, então deixe-o desativado para corpos REST, arquivos de configuração e payloads de mensagens.

Verifique Idas e Voltas com Trocar

Antes de enviar dados com escape para um pipeline, clique em Trocar direção para desfazer o escape e confirmar que você recupera o texto original. Isso detecta escape duplo acidental — uma fonte frequente de \\n aparecendo onde se pretendia \n. Reverta a qualquer momento com nossa ferramenta de Des-escape de JSON.

Perguntas Frequentes