[Home](./index.md) > [@firebase/firestore](./firestore.md) > [/](./firestore_.md) > [onSnapshot](./firestore_.onsnapshot_6.md) ## onSnapshot() function Attaches a listener for `QuerySnapshot` events. You may either pass individual `onNext` and `onError` callbacks or pass a single observer object with `next` and `error` callbacks. The listener can be cancelled by calling the function that is returned when `onSnapshot` is called. NOTE: Although an `onCompletion` callback can be provided, it will never be called because the snapshot stream is never-ending. Signature: ```typescript export declare function onSnapshot(query: Query, onNext: (snapshot: QuerySnapshot) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe; ``` ## Parameters | Parameter | Type | Description | | --- | --- | --- | | query | [Query](./firestore_.query.md)<T> | The query to listen to. | | onNext | (snapshot: [QuerySnapshot](./firestore_.querysnapshot.md)<T>) => void | A callback to be called every time a new QuerySnapshot is available. | | onError | (error: [FirestoreError](./firestore_.firestoreerror.md)) => void | A callback to be called if the listen fails or is cancelled. No further callbacks will occur. | | onCompletion | () => void | Can be provided, but will not be called since streams are never ending. | Returns: [Unsubscribe](./firestore_.unsubscribe.md) An unsubscribe function that can be called to cancel the snapshot listener.