Binary-parser
lastmod 2026-11-16created 2026-01-062 edits
binary-parser는 JavaScript 용 바이너리 파서 빌더 라이브러리이다. new Parser() 에 필드 정의 메서드를 체인으로 이어 바이너리 포맷의 구조를 선언하면, 처음 parse() 를 부를 때 그에 맞는 파싱 코드를 생성·컴파일해 캐시한다. 그래서 선언형으로 쓰면서도 손으로 짠 파서만큼 빠르게 돈다는 것이 이 라이브러리의 설명이다. Ruby 의 BinData 와 Node.js 의 binary 패키지에서 영향을 받았다.
About
- 8·16·32·64비트 정수(64비트는
bigint), 32·64비트 부동소수점, 1~32비트 비트 필드, 고정·가변·NUL 종료 문자열, 배열, choice, pointer 와 이들을 조합한 사용자 정의 타입 지원 - 메서드 이름 끝의
le/be로 바이트 순서를 정하고,endianness()로 기본값을 바꿈 - 길이는 숫자, 앞서 읽은 필드 이름, 함수로 지정할 수 있어 길이 필드를 먼저 읽는 가변 구조를 표현함
-
pointer,saveOffset,seek으로 오프셋 기반 포맷을 다루고,wrapped는 읽은 블록을 함수로 변환(예: 압축 해제)한 뒤 다른 파서로 넘김 -
namely()로 파서에 별칭을 붙이면 자기 자신을 참조하는 재귀 구조를 파싱할 수 있음 - 모든 필드에 값을 변환하는
formatter와 매직 넘버 확인 등에 쓰는assert옵션 - npm 패키지는 ES 모듈로 배포되며, CommonJS 는 Node.js 22.12 이상에서
require()로 불러옴. Node.js, Bun, Deno, 웹 브라우저에서 테스트됨 - MIT 라이선스
See also
- JavaScript
- Node.js
- Binary data
- Parser