콘텐츠로 이동

시작하기

StAX-XML은 pure JavaScript parser core로 모든 JavaScript 런타임에서 작동하는 JavaScript/TypeScript용 고성능 풀 기반 XML 파서입니다.

원하시는 패키지 매니저를 사용하여 StAX-XML을 설치하세요:

Terminal window
# npm
npm install stax-xml
# yarn
yarn add stax-xml
# pnpm
pnpm add stax-xml
# bun
bun add stax-xml
# deno
deno add npm:stax-xml

ESM-only 패키지: StAX-XML은 ESM-only로 배포됩니다. require('stax-xml') 대신 import { ... } from 'stax-xml'를 사용하세요.

StAX-XML은 웹 표준 API만을 사용하여 다음과 호환됩니다:

  • Node.js (v20.19+)
  • Bun (모든 버전)
  • Deno (모든 버전)
  • 웹 브라우저 (최신 브라우저)
  • 엣지 런타임 (Vercel, Cloudflare Workers 등)

StAX-XML은 두 가지 주요 파싱 방법을 제공합니다:

스트림을 사용한 대용량 XML 파일의 메모리 효율적인 처리:

import { EventReader } from 'stax-xml';
const reader = new EventReader(readableStream);
for await (const event of reader) {
// XML 이벤트 처리
}

작은 인메모리 XML 문자열의 고성능 파싱:

import { EventReaderSync } from 'stax-xml';
const reader = new EventReaderSync(xmlString);
for (const event of reader) {
// XML 이벤트 처리
}

대용량 byte-oriented workload에서는 StreamReader 또는 StreamReaderSync를 사용하고, 각 StreamBatcheventCount와 index accessor로 소비하세요.