빠른 소식

TanStack DB main, 새로고침 뒤에도 남는 IndexedDB 컬렉션 추가

·설명 약 2분·작성: 해비·블로그 소개

이번 소식

TanStack DB의 개발 브랜치인 main에 IndexedDB 기반 컬렉션 변경이 병합됐습니다. 브라우저 안에 데이터를 보관하면서 TanStack DB의 실시간 쿼리와 낙관적 변경을 함께 쓰는 @tanstack/indexeddb-db-collection입니다. 패키지 정식 출시를 확인한 소식은 아닙니다.

달라진 점

  • 저장된 행을 컬렉션 시작 시 복원해 새로고침·다음 방문에도 이어 사용할 수 있습니다. 로컬 읽기·쓰기에 서버 연결이 필요하지 않습니다.
  • 화면에는 변경을 먼저 반영하고 저장은 비동기로 진행합니다. 변경에 따른 필터·정렬·집계·조인 결과도 갱신됩니다.
  • 같은 출처의 활성 탭과 전용 워커는 BroadcastChannel로 저장된 변경을 전달받습니다. 날짜·바이너리 등 지원되는 구조화 값도 JSON 문자열 변환 없이 저장합니다.

어떤 점이 달라지나요?

메모·읽기 목록처럼 브라우저에 남겨 둘 데이터를 다루는 앱에서 기존 Collection API를 활용할 수 있는 변경입니다. 다만 각 저장소를 메모리에 올리므로 데이터 크기를 고려해야 합니다.

서버 동기화, 탭 사이 충돌 해결, 오프라인에서 앱 자체를 처음 여는 캐시는 별도 구성이 필요합니다. 브라우저 저장 용량 제한·자동 삭제·사용자 삭제도 그대로 적용됩니다. 앱이 완전히 오프라인으로 동작하거나 데이터가 영구 보장된다는 뜻은 아닙니다.

공식 출처·변경 시점

main 병합: 2026년 10월 7일 03:58:09 KST. 예전 PR의 작성일이 아니라 이번 실제 병합을 기준으로 정리했습니다. 실행·브라우저 검증은 직접 재현하지 않았습니다.

원문 출처 보기 →

이 소식이 도움이 되었나요?

댓글 0

이 글을 쓴 해비

웹사이트를 제작·운영하고, 개인 서비스와 자동화·AI 도구를 만듭니다. 직접 만들며 배운 내용과 문제 해결 과정을 BlogFlow에 기록합니다.

새 글 받아보기

RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.

RSS 피드 구독하기

댓글 남기기