API 레퍼런스

@ilokesto/store 패키지는 단일 클래스인 Store<T>를 내보냅니다.

제공된 초기 상태로 새로운 스토어 인스턴스를 생성합니다.

const store = new Store({ count: 0 });

스토어의 현재 상태를 반환합니다.

const state = store.getState();

반환된 상태는 직접적인 수정을 방지하기 위해 Readonly<T> 타입으로 지정됩니다. Readonly<T>의 의미에 대해서는 시맨틱을 참조하십시오.

생성자에 원래 전달되었던 상태를 반환합니다. 이는 스토어를 원래 값으로 재설정할 때 유용합니다.

const initial = store.getInitialState();

스토어 상태를 업데이트합니다. 새 상태 값이나 업데이트 함수를 인자로 받습니다.

// 값 교체
store.setState({ count: 1 });

// 업데이트 함수
store.setState((prev) => ({ ...prev, count: prev.count + 1 }));

베일아웃(bailout) 규칙 및 불변성 패턴을 포함한 업데이트 동작에 대한 자세한 내용은 업데이트 시맨틱을 참조하십시오.

상태가 변경될 때마다 동기적으로 실행될 콜백을 등록합니다.

const unsubscribe = store.subscribe(() => {
  console.log("새 상태:", store.getState());
});

// 구독 중단 시:
unsubscribe();

구독 생명주기 및 알림 보장에 대한 자세한 내용은 구독을 참조하십시오.

이 패키지는 하나의 공개 클래스인 Store<T>를 내보내며, 생성자와 메서드는 위에서 설명한 내용이 전부입니다.

현재 소스 코드에는 미들웨어 관련 구현도 존재하지만, 여기서는 주된 공개 계약으로 다루지 않고 구현 노트에서 설명합니다.