Base64 인코더·디코더: 텍스트, 이미지 Data URI, JWT 페이로드
브라우저에서 UTF-8 텍스트와 이미지를 Base64로 인코딩하고, Base64를 텍스트로 되돌리거나 이미지로 미리 볼 수 있습니다. 중국어, 이모지, 줄바꿈 입력을 지원하지만 표준 Base64만 됩니다. URL-safe 형식과 원본 JWT 세그먼트는 먼저 변환해야 하고, 바이너리는 UTF-8로 디코딩되어 깨집니다.
이 Base64 도구가 처리하는 것과 하지 않는 것
UTF-8 텍스트 양방향 변환
입력할 때 바로 변환합니다. TextEncoder로 UTF-8 바이트로 바꾼 뒤 Base64로 인코딩하므로 중국어, 일본어, 이모지가 올바르게 나오고, 비 Latin-1 문자에 btoa를 직접 쓰면 나는 오류도 발생하지 않습니다.
이미지는 Data URI로
Image로 전환해 파일을 고르면 data:image/...;base64,... 로 읽힙니다. 이 Data URI를 Base64 상자에 붙이면 인라인으로 미리 보이고, 잘못된 내용은 깨진 이미지 대신 대체 메시지로 표시됩니다.
표준 Base64만 지원, URL-safe 없음
- 와 _ 문자는 거부되므로 JWT 페이로드나 URL-safe 토큰은 + 와 / 로 바꿔야 합니다. = 패딩이 없으면 허용되고 공백, 탭, 줄바꿈은 무시됩니다.
디코딩은 UTF-8 기준
바이너리 Base64는 UTF-8 텍스트로 디코딩되어 오류 대신 대체 문자가 나옵니다. 깨끗하게 왕복되는 것은 UTF-8 텍스트뿐이며, 이미지 같은 바이트는 이 방법으로 복원되지 않습니다.
로컬 실행, 하지만 큰 입력은 실패
업로드는 없고 키 입력마다 동기 변환합니다. 크기 보호가 없어 매우 긴 텍스트에서는 모든 바이트를 한 번에 btoa로 펼치다 호출 스택 초과가 날 수 있습니다.
Base64 FAQ
URL-safe Base64(- 와 _)를 지원하나요?
지원하지 않습니다. 표준 + / 만 되며 - 나 _ 는 InvalidCharacterError입니다. - 를 +로, _ 를 /로 바꾸고 4의 배수까지 패딩한 뒤 붙이세요.
JWT 페이로드를 여기서 디코딩할 수 있나요?
변환 후에만 됩니다. 페이로드는 패딩 없는 URL-safe Base64이고 이 페이지는 토큰을 나누거나 빠진 문자를 채우지 않습니다. 변환한 세그먼트를 붙이세요. 결과는 일반 텍스트이며 JSON으로 파싱되지 않습니다.
파일과 Base64를 상호 변환할 수 있나요?
이미지만 되고 파일 방향은 업로드뿐입니다. 이미지를 고르면 Data URI를 얻습니다. 텍스트 파일 선택은 없고, 디코딩 결과도 다운로드 가능한 파일이 아닙니다.
중국어나 이모지는 되는데 btoa는 원래 오류가 나는 이유?
TextEncoder로 UTF-8 바이트로 바꾼 뒤 btoa를 호출하고 TextDecoder로 되돌립니다. 中文 을 btoa에 직접 넘기면 InvalidCharacterError가 나지만 여기서는 나지 않습니다.
바이너리(비 UTF-8) Base64는 어떻게 되나요?
UTF-8로 디코딩되어 임의 바이트가 대체 문자가 됩니다. 실패도 오류 표시도 없습니다. 바이트를 보존하려면 이미지 미리보기나 전용 바이너리 디코더를 쓰세요.
크기 제한이 있나요? 업로드되나요?
업로드 없고 명시적 상한도 없습니다. 입력마다 동기 변환하므로 매우 큰 입력에서 Maximum call stack size exceeded가 나고, 수 MB에서는 탭이 멈출 수 있습니다.
패딩, 공백, 잘못된 입력은 어떻게 처리되나요?
= 누락은 허용되고 atob은 공백, 탭, 줄바꿈을 무시합니다. 길이가 % 4 == 1이거나 알파벳 밖 문자가 있으면 InvalidCharacterError가 나고 UI에는 오류가 표시되지 않습니다.

