foxnail

OPEN_GRID 1.7.0 — 넓은 그리드 · 엑셀 스트리밍

2026. 11. 22  ·  OPEN GRID

OPEN_GRID 1.7.0 발행 완료. 넓은 그리드(10만 행 × 50 컬럼)에서 조작 지연·미세 끊김을 걷어냈다. 대용량 엑셀 내보내기를 스트리밍으로 바꿔 10만 행급 표에서도 브라우저가 죽지 않고 진척바로 저장이 보인다. 공개 API는 더하기만 — 기존 코드 수정 없이 그대로 동작한다.

요약

  • 추가사항 1. 넓은 그리드(10만 행 × 50 컬럼, 셀마다 200자) 성능 개선 — 너비 조절·가로 스크롤·세로 휠·푸터 합계·정렬이 전부 수 배 ~ 수십 배 빨라짐.
  • 추가사항 2. 대용량 엑셀 내보내기(exportExcel) 스트리밍 경로 — 10만 행급에서 메모리 폭주로 죽던 문제 해소. 진척바·취소·디스크 직행 스트리밍(Chromium 계열) + Blob 폴백(그 외 브라우저).
  • 수정사항. 너비 손잡이 리스너 누수(destroy 후 잔존) · LTR 음수 스크롤이 RTL 상태로 걸리던 것 · 가상화 차분 중 편집 행 재생성 · 스트리밍 숫자가 1e21 같은 지수 표기로 조용히 바뀌던 것.
  • 공개 API 변경. 모두 더하기만. ExportOptions에 stream·onProgress·signal·onError 추가. 적용 시 기존 것 별도 수정 필요 없음.
  • 지원 프레임워크. Vanilla · React · Vue · Angular(2 이상) · AngularJS(1.x) · jQuery. 변동 없음.

1. 넓은 그리드 성능

재현 환경. 10만 행 × 50 컬럼 · 셀마다 한국어 200자 · Chromium 기본 메모리 한도. 상용 데모와 같은 조건.

내용. 가로·세로 가상화 + 세로 행 차분(바뀐 행만 다시 그림) + 실시간 너비 조절 + 푸터 합계 스트리밍 계산.

1.1 테스트 결과(실측)

항목 수정 전 1.7.0 내용
너비 조절 손 뗌 → 반영 3,489ms 27ms 약 129배
가로 한 걸음 p95 1,667ms 16.8ms 약 99배
세로 휠 3행 p50 1,183ms 16.7ms 약 71배(세로 행 차분)
푸터 50 컬럼 첫 표시 7,700ms 700ms 약 11배
정렬 200자 1회차 7,513ms 205ms 약 37배(목표 150ms 미달 — 다음 버전 후보)
같은 컬럼 다시 정렬 — 129ms 캐시 경로

관련 예제. perf-million(기존) — 10만 행 × 50 컬럼. 조작 반응이 눈에 보이게 달라졌다.

수정사항 누락 건(정직 고지).

  • 정렬 200자 1회차 205ms — 목표 150ms 미달로 공개. 다음 버전 후보.
  • 번들 코어 청크 gzip 119,004B — 권고선 108,000B를 11,004B 초과. 무거운 writer·xlsx·진척바는 지연 청크로 분리했지만 자체 본문 증분이 남음. 게이트 숫자는 올리지 않음.
  • Firefox · WebKit 벤치는 Chromium 기준만 적용했다. 다음 버전에서 측정.

2. 대용량 엑셀 내보내기 — 스트리밍

문제. exportExcel()이 10만 × 50 전 행을 메모리에 적재해 메인 스레드에서 조립. 재현 시 60초 안에 다운로드가 시작되지 않고 브라우저 창이 멈춤.

내용(바뀐 것).

  • 스트리밍 xlsx writer — 행 단위로 ZIP에 흘려 보냄(인라인 문자열·고정 스타일 인덱스).
  • 디스크 직행 싱크(FileSystemByteSink) — 저장 위치 대화상자에서 고른 파일로 직접 써서 메모리 폭주 없음. Chromium 계열(Chrome · Edge).
  • Blob 폴백 싱크 — File System Access를 지원하지 않는 Firefox · Safari용. 압축된 바이트만 들고 있다가 저장. 큰 표에서는 메모리 사용에 주의.
  • 자동 라우팅 — 5만 행 이상 또는 32MB 이상 추정이면 자동으로 스트리밍 경로. 그보다 작은 표는 기존 스타일 경로 그대로.
  • 진척바 UI — 모달. 퍼센트 · 진행 행수 · 취소 단추.
  • i18n — 한국어 · 영어.

2.1 10만 행 실측

항목 값
프리즈 · 크래시 없음
다운로드 완료 OK(파일 유효 — SheetJS 왕복 검증, 3,000행 샘플 완전 검증)
진척바 · 취소 동작 확인
Chrome 저장 방식 디스크 직행 스트리밍(OOM 0)
Firefox · Safari 저장 방식 Blob 폴백(메모리 보유)
파일 크기 · 소요 시간 약 492MB · 약 80초(압축 ~4:1, 데이터 자체가 2GB급이라 압축 전 크기 자체가 큼)

2.2 ExportOptions 추가 속성

전부 더하기만. 지정하지 않으면 기존 동작과 같다.

속성 타입 내용
stream 'auto' | 'force' | 'off' 기본 'auto'. 임계값 넘으면 스트리밍 경로. 'off'면 소형 경로 유지.
onProgress (done, total) => void 진척 콜백. 호출자가 자기 UI를 쓸 때 사용.
signal AbortSignal 호출자가 취소를 보낼 때.
onError (err) => void 스트리밍 중 발생한 오류 후속 처리.

수정사항 누락 건(정직 고지). 스트리밍 경로는 셀 단위 색상 스타일을 적용하지 않는다(머리글 · 줄무늬 등 고정 스타일만). 셀 단위 색 지정이 필요한 작은 표는 기존 소형 경로가 그대로 쓰여 엑셀에 적용완료. Excel의 셀 32,767자 한도는 강제하지 않는다(이전 버전과 동일).

3. 수정사항(코어)

  • 너비 손잡이 리스너 누수 — ResizeHandleBinder가 destroy 뒤에도 키 리스너를 남기던 것. AbortController로 모두 떨어뜨리게 수정.
  • LTR 음수 scrollLeft가 RTL로 걸리던 것 — ScrollObserver가 한 번 음수로 들어오면 RTL 모드로 고착. 실제 방향 확인 후 걸도록 수정.
  • 세로 차분 중 편집 행 재생성 — BodyView._diffRows에서 편집 중인 행이 다시 그려지면 편집 상태가 깨졌다. 편집 행은 차분에서 제외.
  • 스트리밍 숫자 지수 표기로 조용히 바뀌던 것 — 1e21처럼 아주 큰 수를 toString이 지수로 바꿔 넣던 자리를 rawText 우선으로 교정. SheetJS 왕복으로 확증.

4. 테스트 결과

항목 건 수
통과 3,432
실패 0
건너뜀 2
tsc 오류 0
arch:check 위반 0

코드 검토 2회(넓은 그리드 · 엑셀 스트리밍) 반영 완료. 엑셀 산출물은 독립 대조군 SheetJS로 왕복 검증.

5. 다운로드 링크

다음 버전 후보. 정렬 200자 150ms 안 · Firefox · WebKit 벤치 · 번들 코어 추가 감량.

공유하기