Function useList

src/useList/index.ts:58–124

(
    fetcher: Fetcher<T, P>,
    initialParams: P | (() => P),
    rawOptions: IUseListOptions = { immediate: true }
)

}

export default function useList<T extends Record<string, any>, P extends Record<string, any>>(
    fetcher: Fetcher<T, P>,
    initialParams: P | (() => P),
    rawOptions: IUseListOptions = { immediate: true }
): UseListResponseState<T, P> {
    const [error, setError] = useState<Error | undefined>(undefined);
    const [data, setData] = useState<T[]>([]);
    const [total, setTotal] = useState(0);
    const [params, setParams] = useState<P>(initialParams);
    const [loading, setLoading] = useState(false);
    const lastRequestId = useRef<symbol | undefined>(undefined);

    const options = useMemo(() => merge({ immediate: true }, rawOptions), [rawOptions]);

    const performFetch = (raw = params) => {
        const requestId = Symbol('id');
        lastRequestId.current = requestId;
        setLoading(true);
        fetcher(raw)
            .then(({ data, total }) => {
                setData(data);
                setTotal(total);
            })
            .catch(setError)
            .finally(() => {
                lastRequestId.current === requestId && setLoading(false);
            });
    };

    const mutate = (next: Partial<P> | ((prev: P) => P) = params, options: IMutateOptions = {}) => {
        const defaultOptions: IMutateOptions = {
            revalidate: true,
            clearData: true,
        };
        const nextOptions = merge(defaultOptions, options);

        const tmp = typeof next === 'function' ? next(params) : { ...merge({}, params, next) };
        setParams(tmp);

        if (nextOptions.revalidate) {
            if (nextOptions.clearData) {
                clearData();
            }
            performFetch(tmp);
        }
    };

    const clearData = () => {
        setData([]);
        setTotal(0);
        setError(undefined);
    };

    const clear = () => {
        clearData();
        setParams(initialParams);
        setLoading(false);
    };