콘텐츠로 이동
Search

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

Favorite site

author Zer0, MCPBot sitemap