hwpjs (ohah)

hwpjs는 브라우저에서 HWP 문서를 다루는 JavaScript 라이브러리입니다. 2021년 7월 시작해 2026년 8월 기준 스타 162개·포크 23개를 기록 중입니다.

무엇을 해결하나

웹 서비스에서 사용자가 HWP 파일을 올렸을 때 미리보기를 보여주려면, 서버에서 변환하거나 브라우저에서 직접 렌더링해야 합니다. 서버 변환은 인프라 비용과 지연이 생기고, 파일을 서버로 올려야 해서 보안 이슈도 따라옵니다. 브라우저에서 바로 파싱하면 이 둘을 모두 피할 수 있습니다.

브라우저 렌더링의 장점

• 파일이 서버로 안 올라감: 보안·개인정보 측면 유리
• 변환 서버 인프라 불필요
• 업로드 대기 없이 즉시 미리보기
• 정적 호스팅만으로 동작 가능

실무에서 쓰이는 맥락

채용 사이트(이력서 HWP 업로드), 공공기관 민원 시스템, 학교 과제 제출, 문서 공유 서비스 등 “사용자가 HWP를 올리는” 모든 서비스가 대상입니다. 한국 웹 서비스에서는 흔한 요구인데 해결책은 많지 않습니다.

WASM 기반과의 관계

최근에는 Rust로 파서를 만들고 WebAssembly로 빌드하는 방식(rhwp)이 성능상 유리합니다. 다만 순수 JavaScript 구현은 빌드 체인이 단순하고 기존 프론트엔드 프로젝트에 바로 얹기 쉽다는 장점이 있어, 요구 수준에 따라 선택이 갈립니다.

서버를 세울 여력이 없을 때

프론트엔드 개발자가 자기 영역에서 한국 특유의 문제를 푸는 방식입니다. 백엔드 변환 서버를 세울 여력이 없는 1인 개발자에게는, 브라우저에서 끝내는 접근이 유일하게 현실적인 선택인 경우가 많습니다.

같은 결의 한국 HWP 생태계 프로젝트

• rhwp (Rust·WASM 뷰어·에디터)
• hwpers (Rust 파서)
• hwplib · hwpxlib (Java 라이브러리)
• pyhwp (Python 파서)
• 알한글 macOS (macOS 네이티브 뷰어)

그리고 비공식 구현이라 HWP 사양이 바뀌면 따라가야 합니다. 문서가 안 열릴 때 원인을 파악하기 어렵다는 점도 감안해야 합니다.

이런 분께 맞아요

• 웹 서비스에 HWP 미리보기를 붙여야 하는 프론트엔드 개발자
• 사용자가 한글 문서를 업로드하는 서비스 운영자
• 서버 없이 문서를 처리하고 싶은 1인 개발자
• JavaScript로 바이너리 포맷을 다루는 방법을 배우려는 사람