es-hangul

es-hangul은 한글 문자를 다루는 모던 자바스크립트 라이브러리입니다. 토스(toss)가 공개했습니다.

GitHub 현황 (2026년 8월 기준)

• 스타 1,863 · 포크 143
• 라이선스 MIT · 저장소 toss/es-hangul
• 생성 2024-03-29 · 마지막 push 2026-07-09
• 문서 es-hangul.slash.page

한글 처리 라이브러리가 다시 나온 이유

한글 자모 처리 라이브러리는 예전부터 있었습니다. 그런데 대부분 10년 전 자바스크립트 환경에 맞춰져 있어 타입 정의가 없거나 번들 크기가 크거나 트리 셰이킹이 안 됩니다.

es-hangul은 같은 기능을 현대적 패키징으로 다시 만든 쪽입니다. 새로운 문제를 푸는 게 아니라 오래된 해결책을 지금 환경에 맞춘 프로젝트입니다.

실제로 쓰는 기능

• 조사 붙이기: “철수가/영희가”, “책을/사과를” 자동 판별
• 초성 검색: “ㅅㅈ”으로 “소진” 찾기
• 자모 분해·조합: 타이핑 중간 상태 처리
• 로마자 변환

그리고 조사 판별은 외래어와 숫자에서 예외가 생깁니다. “iPhone은/iPhone는” 같은 경우 발음 기준을 어떻게 잡느냐에 따라 결과가 갈리므로, 사용자에게 보이는 문장이라면 표본 확인이 필요합니다.

함께 볼 한글 처리 라이브러리

• Hangul.js: 자모 분해·조합 오토마타(2025-03 갱신)
• go-hangul: Go용, 14년째 유지
• Josa.js: 조사 구분에 특화
• inko: 영타↔한글 변환

es-hangul은 이 중 가장 늦게 나왔고 가장 넓습니다. 기존 라이브러리들이 한 가지씩 맡았던 것을 한 패키지에 모았고, 타입스크립트와 트리 셰이킹을 전제로 만들었습니다. 새 프로젝트라면 여기부터 보는 편이 합리적입니다.

이런 분께 맞아요

• 한글 조사·초성 검색이 필요한 프론트엔드 개발자
• 타입스크립트 프로젝트에서 한글을 다루는 팀
• 오래된 한글 라이브러리를 교체하려는 개발자
• 한글 처리 API 설계를 참고하려는 사람