Escapador de String JSON

O que é Escape de Strings JSON?

O escape de strings JSON é o processo de converter caracteres especiais dentro de uma string em sequências de escape que os parsers JSON conseguem ler sem quebrar a estrutura. A especificação JSON (ECMA-404 / RFC 8259) exige que determinados caracteres dentro de valores de string sejam precedidos por uma barra invertida. Sem o escape adequado, uma aspas dupla literal ou uma quebra de linha dentro de uma string encerraria a string prematuramente e produziria um erro de análise.

Toda string JSON é delimitada por aspas duplas. Quando a própria string contém aspas duplas, barras invertidas ou caracteres de controle (U+0000 a U+001F), o caractere deve ser substituído pela sua sequência de escape. Por exemplo, uma quebra de linha literal vira \n, uma tabulação vira \t e aspas duplas viram \". Qualquer ponto de código Unicode também pode ser representado como \uXXXX, onde XXXX é o valor hexadecimal de quatro dígitos.

O unescape (operação inversa) converte essas sequências com barra invertida de volta nos caracteres originais. Use-o quando receber um payload JSON onde os valores de string estão com duplo escape, ou quando precisar extrair texto bruto de uma entrada de log JSON para exibição em uma interface ou terminal. Pipelines de agregação de logs encontram isso constantemente: quando uma mensagem codificada em JSON é armazenada como valor de string dentro de outro documento JSON, cada barra invertida na string interna chega duplicada.

Por que usar uma ferramenta de escape JSON?

Adicionar ou remover barras invertidas manualmente é tedioso e sujeito a erros, especialmente ao lidar com texto multilinha, caminhos de arquivo ou trechos de código embutidos. Uma ferramenta dedicada de escape detecta casos extremos que a edição manual deixa passar.

Casos de uso do Escape de Strings JSON

Referência de Sequências de Escape JSON

A especificação JSON define exatamente dois escapes obrigatórios (aspas dupla e barra invertida) e seis sequências de escape curtas para caracteres de controle comuns. Todos os outros caracteres de controle (U+0000 a U+001F) devem usar a forma \uXXXX. Caracteres acima de U+FFFF (como emoji) podem ser representados como um par substituto UTF-16: \uD83D\uDE00.

Escape JSON vs. Codificação JSON

Desenvolvedores às vezes confundem escapar uma string com codificar um documento JSON completo.

Exemplos de código

Todas as principais linguagens têm funções nativas para isso. Exemplos em JavaScript, Python, Go e jq:

// JSON.stringify escapes a value and wraps it in quotes
JSON.stringify('Line 1\nLine 2')       // → '"Line 1\\nLine 2"'

// To get just the inner escaped string (no surrounding quotes):
const escaped = JSON.stringify('She said "hello"').slice(1, -1)
// → 'She said \\"hello\\"'

// Parsing reverses the escaping
JSON.parse('"tabs\\tand\\nnewlines"')  // → 'tabs\tand\nnewlines'

// Handling Unicode: emoji in JSON
JSON.stringify('Price: 5\u20ac')       // → '"Price: 5\u20ac"' (raw euro sign)

import json

# json.dumps escapes and quotes a string
json.dumps('Line 1\nLine 2')           # → '"Line 1\\nLine 2"'

# Ensure ASCII: replace non-ASCII with \uXXXX sequences
json.dumps('Caf\u00e9', ensure_ascii=True)   # → '"Caf\\u00e9"'

# Keep UTF-8 characters as-is (default in Python 3)
json.dumps('Caf\u00e9', ensure_ascii=False)  # → '"Caf\u00e9"'

# Unescape by round-tripping through json.loads
json.loads('"She said \\"hello\\""')      # → 'She said "hello"'

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// json.Marshal escapes a Go string for JSON
	raw := "Line 1\nLine 2\tindented"
	b, _ := json.Marshal(raw)
	fmt.Println(string(b))
	// → "Line 1\nLine 2\tindented"

	// Unescape with json.Unmarshal
	var out string
	json.Unmarshal([]byte(`"She said \"hello\""`), &out)
	fmt.Println(out)
	// → She said "hello"
}

# Escape a raw string into a JSON-safe value
echo 'Line 1
Line 2	with tab' | jq -Rs '.'
# → "Line 1\nLine 2\twith tab\n"

# Unescape a JSON string back to raw text
echo '"She said \"hello\""' | jq -r '.'
# → She said "hello"

Perguntas frequentes