react-firehooks
Version:
Lightweight dependency-free collection of React hooks for Firebase
20 lines (19 loc) • 1.29 kB
TypeScript
import { DataSnapshot, Query } from "firebase/database";
import type { ValueHookResult } from "../common/index.js";
export type UseObjectValueOnceResult<Value = unknown> = ValueHookResult<Value, Error>;
export type UseObjectValueOnceConverter<Value> = (snap: DataSnapshot) => Value;
export interface UseObjectValueOnceOptions<Value> {
converter?: UseObjectValueOnceConverter<Value> | undefined;
}
/**
* Returns the DataSnapshot of the Realtime Database query. Does not update the DataSnapshot once initially fetched
* @template Value Type of the object value
* @param query Realtime Database query
* @param options Options to configure how the object is fetched
* `converter`: Function to extract the desired data from the DataSnapshot. Similar to Firestore converters. Default: `snap.val()`.
* @returns User, loading state, and error
* - value: Object value; `undefined` if query is currently being fetched, or an error occurred
* - loading: `true` while fetching the query; `false` if the query was fetched successfully or an error occurred
* - error: `undefined` if no error occurred
*/
export declare function useObjectValueOnce<Value = unknown>(query: Query | undefined | null, options?: UseObjectValueOnceOptions<Value> | undefined): UseObjectValueOnceResult<Value>;