Escape JSON (sekwencje ucieczki)

Czym jest escape'owanie 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}"}

Kluczowe funkcje

Przykłady

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

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

She said "hello"	then left.

Price: 9.99€ — café société

Jak używać

1. 1

   Wklej swój tekst lub JSON

   Wpisz lub wklej cokolwiek do pola wejściowego — obiekt JSON, fragment kodu, wiersz logu lub zwykły tekst. Escape'owany wynik pojawia się natychmiast. Kliknij „Wczytaj przykład”, aby wypróbować próbkę, np. ładunek JSON-in-JSON lub wieloliniową funkcję.

2. 2

   Wybierz opcje escape'owania

   Pozostaw „Zawiń w podwójne cudzysłowy” włączone dla pełnego literału napisu JSON (tak samo jak JSON.stringify) lub wyłączone, aby otrzymać samą escape'owaną treść. Przełącz „Escape znaków spoza ASCII” dla wyniku \uXXXX w czystym ASCII oraz „Escape ukośnika” przy osadzaniu JSON w znaczniku HTML <script>.

3. 3

   Skopiuj escape'owany napis

   Kliknij Kopiuj, aby pobrać wynik gotowy do wklejenia do dokumentu JSON, treści żądania REST lub pliku konfiguracyjnego. Kliknij Zamień kierunek, aby przełączyć w tryb unescape i zweryfikować bezstratną konwersję w obie strony.

Częste pułapki escape'owania

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)

Częste zastosowania

Ładunki webhooków JSON-in-JSON

Zastosuj escape do treści żądania, aby można było ją przechować jako pole napisu wewnątrz koperty webhooka, komunikatu Kafki lub logu audytu. Pozostaw Zawiń włączone, a wynik jest gotowy do przypisania do klucza w zewnętrznym dokumencie.

Wieloliniowe fragmenty w konfiguracji

Zamień wieloliniowy skrypt powłoki, zapytanie SQL lub fragment kodu na pojedynczą wartość napisu JSON. Każda nowa linia staje się \n, więc plik konfiguracyjny JSON pozostaje poprawny w jednej linii.

Ręcznie budowane treści żądań REST

Zastosuj escape do napisu JSON przed umieszczeniem go w argumencie curl --data lub kliencie HTTP, aby cudzysłowy i znaki nowej linii przetrwały powłokę i sieć bez psucia żądania.

Kodowanie napisów bezpieczne dla logów

Zastosuj escape do treści dostarczonej przez użytkownika przed zapisaniem jej w strukturalnym wierszu logu, zapobiegając wstrzykniętym cudzysłowom lub znakom nowej linii przed uszkodzeniem formatu logu lub parsera logów JSON w dalszej części potoku.

Integracje ze starszymi systemami tylko ASCII

Wytwórz wynik \uXXXX w czystym ASCII dla bram SOAP, nagłówków e-mail lub starszych systemów, które przekłamują UTF-8 w transmisji, zachowując pełną dekodowalność przez dowolny nowoczesny parser JSON.

Osadzanie JSON w HTML

Zastosuj escape do ukośników, aby blok JSON można było osadzić bezpośrednio wewnątrz znacznika <script> na stronach renderowanych po stronie serwera, bez tego, by </script> wewnątrz danych zamknęło znacznik za wcześnie.

Szczegóły techniczne

Algorytm escape'owania

Narzędzie serializuje Twoje wejście zgodnie z regułami napisów specyfikacji JSON: U+0022 (") → \", U+005C (\) → \\, U+0008 → \b, U+000C → \f, U+000A → \n, U+000D → \r, U+0009 → \t, a każdy inny znak poniżej U+0020 → \u00XX. Przy włączonym Zawiń otaczające podwójne cudzysłowy są dołączane; przy wyłączonym są usuwane. Odpowiada to dokładnie wynikowi zgodnego serializatora, gwarantując bezstratną konwersję w obie strony.

Unicode i pary surogatów

Domyślnie znaki powyżej U+007F są emitowane jako dosłowne UTF-8, które JSON dopuszcza. Przy włączonym Escape znaków spoza ASCII każdy taki znak jest zamieniany na \uXXXX z użyciem jego jednostki kodowej UTF-16; znaki spoza Podstawowej Płaszczyzny Wielojęzycznej (emoji, rzadkie pisma) są kodowane jako para surogatów dwóch sekwencji \uXXXX — na przykład 😀 (U+1F600) staje się \ud83d\ude00, czyli ta sama reprezentacja, którą produkuje serializator JSON.

Ukośnik i kontekst HTML

JSON nie wymaga escape'owania /, więc domyślnie jest zachowywany. Gdy Escape ukośnika jest włączony, każdy / staje się \/. Jedynym praktycznym powodem, aby to zrobić, jest osadzanie w HTML: wewnątrz znacznika <script> dosłowny podciąg </script> zamyka znacznik niezależnie od kontekstu JSON, więc escape'owanie ukośnika do <\/script> zachowuje osadzony JSON nienaruszony, pozostając zgodnym ze specyfikacją.

Dobre praktyki

Trzymaj Zawiń włączone dla pełnych literałów

Gdy potrzebujesz wartości do przypisania w kodzie lub wklejenia po dwukropku w JSON, trzymaj Zawiń w podwójne cudzysłowy włączone — wynik to pełny, parsowalny napis JSON identyczny z JSON.stringify. Wyłączaj tylko wtedy, gdy sam ręcznie wpisujesz otaczające cudzysłowy.

Zostaw escape Unicode wyłączony, chyba że jest wymagany

Surowe UTF-8 to poprawny JSON i jest znacznie czytelniejsze. Włącz Escape znaków spoza ASCII tylko dla konkretnego systemu w dalszej części potoku, który źle obsługuje UTF-8 (starsze SOAP, niektóre potoki logów, pliki źródłowe tylko ASCII). Escape'owanie wszystkiego domyślnie czyni wynik jedynie bardziej zaszumionym.

Escape'uj ukośniki tylko przy osadzaniu w HTML

Escape ukośnika ma znaczenie dokładnie w jednym miejscu: JSON osadzony w znaczniku HTML <script>. Poza tym kontekstem dodaje bałaganu bez korzyści, więc zostaw go wyłączonego dla treści REST, plików konfiguracyjnych i ładunków komunikatów.

Weryfikuj konwersję w obie strony przez Zamień

Przed wysłaniem escape'owanych danych do potoku kliknij Zamień kierunek, aby je odescape'ować i potwierdzić, że odzyskujesz oryginalny tekst. To wychwytuje przypadkowe podwójne escape'owanie — częste źródło \\n pojawiającego się tam, gdzie zamierzono \n. Odwróć w dowolnym momencie naszym narzędziem Unescape JSON.

Najczęściej zadawane pytania