ra-core
Version:
Core components of react-admin, a frontend Framework for building admin applications on top of REST services, using ES6, React
49 lines • 2.59 kB
TypeScript
import { RaRecord, GetOneParams, GetOneResult } from '../types';
import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
/**
* Call the dataProvider.getOne() method and return the resolved value
* as well as the loading state.
*
* The return value updates according to the request state:
*
* - start: { isPending: true, isFetching: true, refetch }
* - success: { data: [data from response], isPending: false, refetch }
* - error: { error: [error from response], isPending: false, refetch }
*
* This hook will return the cached result when called a second time
* with the same parameters, until the response arrives.
*
* @param resource The resource name, e.g. 'posts'
* @param {Params} params The getOne parameters { id, meta }, e.g. { id: 123 }
* @param {Options} options Options object to pass to the react-query queryClient.
*
* @typedef Params
* @prop id a resource identifier, e.g. 123
*
* @typedef Options
* @prop enabled Flag to conditionally run the query. If it's false, the query will not run
* @prop onSuccess Side effect function to be executed upon success, e.g. { onSuccess: { refresh: true } }
* @prop onError Side effect function to be executed upon failure, e.g. { onError: error => notify(error.message) }
*
* @returns The current request state. Destructure as { data, error, isPending, refetch }.
*
* @example
*
* import { useGetOne, useRecordContext } from 'react-admin';
*
* const UserProfile = () => {
* const record = useRecordContext();
* const { data, isPending, error } = useGetOne('users', { id: record.id });
* if (isPending) { return <Loading />; }
* if (error) { return <p>ERROR</p>; }
* return <div>User {data.username}</div>;
* };
*/
export declare const useGetOne: <RecordType extends RaRecord<import("../types").Identifier> = any, ErrorType = Error>(resource: string, { id, meta }: Partial<GetOneParams<RecordType>>, options?: UseGetOneOptions<RecordType, ErrorType>) => UseGetOneHookValue<RecordType, ErrorType>;
export type UseGetOneOptions<RecordType extends RaRecord = any, ErrorType = Error> = Omit<UseQueryOptions<GetOneResult<RecordType>['data'], ErrorType>, 'queryKey' | 'queryFn'> & {
onSuccess?: (data: GetOneResult<RecordType>['data']) => void;
onError?: (error: ErrorType) => void;
onSettled?: (data?: GetOneResult<RecordType>['data'], error?: ErrorType | null) => void;
};
export type UseGetOneHookValue<RecordType extends RaRecord = any, ErrorType = Error> = UseQueryResult<GetOneResult<RecordType>['data'], ErrorType>;
//# sourceMappingURL=useGetOne.d.ts.map