Travels
lastmod 2026-11-16created 2025-12-292 edits
Travels는 상태 변경의 차이만 JSON Patch(RFC 6902)로 저장하는 JavaScript undo/redo 라이브러리이다. 변경할 때마다 상태 전체를 복사하는 스냅샷 방식과 달리 바뀐 부분만 기록하므로, 큰 상태를 조금씩 고치는 앱에서 히스토리가 메모리와 저장 공간을 덜 차지한다. 다만 작은 상태와 짧은 히스토리에서는 패치를 만드는 비용 때문에 스냅샷 방식이 더 빠를 수 있다고 README 에서 밝힌다.
About
- 불변 업데이트는 Mutative 위에서 동작해
draft.count++처럼 바로 고치는 코드로 씀 - README 의 권장 구분: 작은 상태·짧은 히스토리는 스냅샷 스택이나 Redux-undo, Zundo. 큰 상태·작은 변경·긴 히스토리·영속화가 필요하면 Travels. 동시 편집 충돌 병합은 CRDT/OT 가 할 일이고 Travels 로는 풀리지 않음
- 자동 아카이브(기본,
setState마다 히스토리 1개)와 수동 아카이브(archive()를 부를 때까지 여러 변경을 한 단계로 묶음) 모드 -
maxHistory로 남길 패치 개수를 제한함. 오래된 패치를 버려도reset()은 처음 상태로 돌아감 - 히스토리를 직렬화해 localStorage·IndexedDB 등에 저장하고
restoreTravels()로 복원함. 저장할 상태는 일반 객체·배열·문자열·유한 숫자·불리언·null이어야 하며Map/Set은 거부함 - React·Vue·Zustand·MobX·Pinia·바닐라 JS 에서 씀. React 훅 use-travel 과 Zustand 미들웨어 zustand-travel 이 따로 있음
- Travels 3 은 서버에서 Node.js 22 이상 필요. MIT 라이선스
See also
- Json
- Mutative JSON Patch