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. 다운로드 링크
- npm — open-grid@1.7.0 (latest · Trusted Publishing)
- unpkg — https://unpkg.com/open-grid@1.7.0/dist/open-grid.js
- 데모 · 가이드 — foxnail.kr/open-grid/demo/v2/
- API 문서(TypeDoc) — foxnail.kr/open-grid/demo/v2/api-docs/
- 공개 저장소 — github.com/farmerkweon/OpenGrid (MIT · 상용도 무료)
다음 버전 후보. 정렬 200자 150ms 안 · Firefox · WebKit 벤치 · 번들 코어 추가 감량.