Store 클래스

Store<T>는 @ilokesto/store가 내보내는 유일한 public class입니다.

import { Store } from "@ilokesto/store";

const store = new Store({ ready: false });

Constructor

new Store<T>(initialState: T)

constructor는 initialState를 첫 현재 상태로 저장하고, 동시에 getInitialState()가 반환할 값으로 보관합니다.

복제는 일어나지 않습니다. 객체를 전달했다면 소유권 규칙을 지키세요. store에 넘긴 뒤에는 그 객체를 불변 값처럼 다루는 편이 안전합니다.

getState(): Readonly<T>

현재 상태를 동기적으로 반환합니다. Readonly<T> 타입은 반환 값을 통해 직접 대입하는 일을 줄여주지만, 런타임 freeze를 만들지는 않으며 TypeScript 관점에서도 깊은 불변은 아닙니다.

const state = store.getState();
console.log(state.ready);

getState()는 다음 경우에 사용하세요.

상태를 제자리에서 직접 수정하기 위한 통로로 사용하지 마세요.

getInitialState(): Readonly<T>

constructor가 잡아 둔 정확한 초기 값을 반환합니다.

const initial = store.getInitialState();

getInitialState()는 store를 reset하지 않습니다. reset하려면 직접 초기 값을 setState()에 다시 전달하세요.

store.setState(store.getInitialState());

현재 상태가 이미 초기 상태와 같은 참조라면 Object.is 때문에 알림이 발생하지 않습니다. 객체 상태 reset에 구독자가 반응해야 한다면 같은 필드를 가진 새 객체를 전달하세요.