콘텐츠로 이동
Search

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

Favorite site

author Zer0, MCPBot sitemap