react-query-firebase / web/firestore / useGetRealtimeDocData

Function: useGetRealtimeDocData()

function useGetRealtimeDocData<AppModelType>(options): object;

Defined in: web/firestore/useGetRealtimeDocData.ts:64

A hook to get realtime updates to a firestore document.

Type Parameters

AppModelType

AppModelType extends AppModel = AppModel

Parameters

options

onError?

(error) => unknown

A callback to be called if the listen fails or is cancelled. No further callbacks will occur.

path?

string

A slash-separated path to a document. Has to be omitted to use

pathSegments?

string[]

Additional path segments that will be applied relative to the first argument.

reference?

DocumentReference<AppModelType, AppModelType>

A reference to a collection.

Returns

object

data

data: null | AppModelType;

error

error: null | FirebaseError;

isError

isError: boolean;

isFetching

isFetching: boolean;

Example

const firebaseConfig = {};
export const MyComponent = () => {
 const result = useGetRealtimeDocData('collection/documentId');
 return (
     <div>
         {JSON.stringify(result)}
     </div>
 );
};