FirebaseFirestore

The entry point of Cloud Firestore, mirroring com.google.firebase.firestore.FirebaseFirestore from the Firebase Android SDK: obtained per FirebaseApp and database with the static accessors (or the Firebase.firestore extensions), it creates references, batches and transactions and manages the network and the local cache.

Not mirrored: loadBundle from JVM streams (see api/android-sdk/exclusions.txt).

The entry point of Cloud Firestore, mirroring com.google.firebase.firestore.FirebaseFirestore from the Firebase Android SDK: obtained per FirebaseApp and database with the static accessors (or the Firebase.firestore extensions), it creates references, batches and transactions and manages the network and the local cache.

Not mirrored: loadBundle from JVM streams (see api/android-sdk/exclusions.txt).

The JS SDK's Firestore must be initialised with its settings (and connected to the emulator) before any use, so the underlying object is created on first use with the settings set until then, as the Android SDK's semantics require. Instances are cached per app and database, as the Android SDK's getInstance.

The JS SDK's Firestore must be initialised with its settings (and connected to the emulator) before any use, so the underlying object is created on first use with the settings set until then, as the Android SDK's semantics require. Instances are cached per app and database, as the Android SDK's getInstance.

Types

Link copied to clipboard
actual object Companion
actual object Companion
expect object Companion
actual object Companion
actual object Companion

Properties

Link copied to clipboard
actual val app: FirebaseApp

The FirebaseApp this instance belongs to.

actual val app: FirebaseApp

The FirebaseApp this instance belongs to.

expect val app: FirebaseApp

The FirebaseApp this instance belongs to.

actual val app: FirebaseApp

The FirebaseApp this instance belongs to.

actual val app: FirebaseApp

The FirebaseApp this instance belongs to.

Link copied to clipboard

The settings; can only be set before the instance is used.

The iOS SDK does not expose the cache settings it was given, so the settings set through the layer are kept per instance.

The settings; can only be set before the instance is used.

The settings; can only be set before the instance is used.

The settings; can only be set before the instance is used.

Link copied to clipboard
val ios: FIRFirestore

The underlying Firebase iOS SDK object.

Link copied to clipboard

The underlying Firebase JS SDK object.

The underlying Firebase JS SDK object.

Link copied to clipboard

The manager of the persistent cache's indexes, or null when persistence is disabled.

The manager of the persistent cache's indexes, or null when persistence is disabled.

The manager of the persistent cache's indexes, or null when persistence is disabled.

The manager of the persistent cache's indexes, or null when persistence is disabled.

The manager of the persistent cache's indexes, or null when persistence is disabled.

Functions

Link copied to clipboard

Registers runnable to be called whenever all the active snapshot listeners are in sync.

actual fun addSnapshotsInSyncListener(runnable: Runnable): ListenerRegistration

Registers runnable to be called whenever all the active snapshot listeners are in sync.

expect fun addSnapshotsInSyncListener(runnable: Runnable): ListenerRegistration

Registers runnable to be called whenever all the active snapshot listeners are in sync.

actual fun addSnapshotsInSyncListener(runnable: Runnable): ListenerRegistration

Registers runnable to be called whenever all the active snapshot listeners are in sync.

actual fun addSnapshotsInSyncListener(runnable: Runnable): ListenerRegistration

Registers runnable to be called whenever all the active snapshot listeners are in sync.

Link copied to clipboard
actual fun batch(): WriteBatch

A new WriteBatch.

actual fun batch(): WriteBatch

A new WriteBatch.

expect fun batch(): WriteBatch

A new WriteBatch.

actual fun batch(): WriteBatch

A new WriteBatch.

actual fun batch(): WriteBatch

A new WriteBatch.

Link copied to clipboard
actual fun clearPersistence(): Task<Nothing?>

Clears the persistent cache; only allowed while the instance is not started or is terminated.

actual fun clearPersistence(): Task<Nothing?>

Clears the persistent cache; only allowed while the instance is not started or is terminated.

expect fun clearPersistence(): Task<Nothing?>

Clears the persistent cache; only allowed while the instance is not started or is terminated.

actual fun clearPersistence(): Task<Nothing?>

Clears the persistent cache; only allowed while the instance is not started or is terminated.

actual fun clearPersistence(): Task<Nothing?>

Clears the persistent cache; only allowed while the instance is not started or is terminated.

Link copied to clipboard
actual fun collection(collectionPath: String): CollectionReference

A CollectionReference for the collection at collectionPath.

actual fun collection(collectionPath: String): CollectionReference

A CollectionReference for the collection at collectionPath.

expect fun collection(collectionPath: String): CollectionReference

A CollectionReference for the collection at collectionPath.

actual fun collection(collectionPath: String): CollectionReference

A CollectionReference for the collection at collectionPath.

actual fun collection(collectionPath: String): CollectionReference

A CollectionReference for the collection at collectionPath.

Link copied to clipboard
actual fun collectionGroup(collectionId: String): Query

A Query over every collection named collectionId.

actual fun collectionGroup(collectionId: String): Query

A Query over every collection named collectionId.

expect fun collectionGroup(collectionId: String): Query

A Query over every collection named collectionId.

actual fun collectionGroup(collectionId: String): Query

A Query over every collection named collectionId.

actual fun collectionGroup(collectionId: String): Query

A Query over every collection named collectionId.

Link copied to clipboard
actual fun disableNetwork(): Task<Nothing?>

Disables network access; reads are served from the cache and writes are queued.

actual fun disableNetwork(): Task<Nothing?>

Disables network access; reads are served from the cache and writes are queued.

expect fun disableNetwork(): Task<Nothing?>

Disables network access; reads are served from the cache and writes are queued.

actual fun disableNetwork(): Task<Nothing?>

Disables network access; reads are served from the cache and writes are queued.

actual fun disableNetwork(): Task<Nothing?>

Disables network access; reads are served from the cache and writes are queued.

Link copied to clipboard
actual fun document(documentPath: String): DocumentReference

A DocumentReference for the document at documentPath.

actual fun document(documentPath: String): DocumentReference

A DocumentReference for the document at documentPath.

expect fun document(documentPath: String): DocumentReference

A DocumentReference for the document at documentPath.

actual fun document(documentPath: String): DocumentReference

A DocumentReference for the document at documentPath.

actual fun document(documentPath: String): DocumentReference

A DocumentReference for the document at documentPath.

Link copied to clipboard
actual fun enableNetwork(): Task<Nothing?>

Re-enables network access after disableNetwork.

actual fun enableNetwork(): Task<Nothing?>

Re-enables network access after disableNetwork.

expect fun enableNetwork(): Task<Nothing?>

Re-enables network access after disableNetwork.

actual fun enableNetwork(): Task<Nothing?>

Re-enables network access after disableNetwork.

actual fun enableNetwork(): Task<Nothing?>

Re-enables network access after disableNetwork.

Link copied to clipboard
open operator override fun equals(other: Any?): Boolean
Link copied to clipboard
actual fun getNamedQuery(name: String): Task<Query?>

The query named name in a loaded bundle, or null.

actual fun getNamedQuery(name: String): Task<Query?>

The query named name in a loaded bundle, or null.

expect fun getNamedQuery(name: String): Task<Query?>

The query named name in a loaded bundle, or null.

actual fun getNamedQuery(name: String): Task<Query?>

The query named name in a loaded bundle, or null.

actual fun getNamedQuery(name: String): Task<Query?>

The query named name in a loaded bundle, or null.

Link copied to clipboard
open override fun hashCode(): Int
Link copied to clipboard
actual fun loadBundle(bundleData: ByteArray): LoadBundleTask

Loads a Firestore bundle into the local cache.

actual fun loadBundle(bundleData: ByteArray): LoadBundleTask

Loads a Firestore bundle into the local cache.

expect fun loadBundle(bundleData: ByteArray): LoadBundleTask

Loads a Firestore bundle into the local cache.

actual fun loadBundle(bundleData: ByteArray): LoadBundleTask

Loads a Firestore bundle into the local cache.

actual fun loadBundle(bundleData: ByteArray): LoadBundleTask

Loads a Firestore bundle into the local cache.

Link copied to clipboard
actual fun pipeline(): PipelineSource

The sources of pipelines over this database (Firestore Pipelines, a Firestore Enterprise edition feature).

actual fun pipeline(): PipelineSource

The sources of pipelines over this database (Firestore Pipelines, a Firestore Enterprise edition feature).

expect fun pipeline(): PipelineSource

The sources of pipelines over this database (Firestore Pipelines, a Firestore Enterprise edition feature).

actual fun pipeline(): PipelineSource

The sources of pipelines over this database (Firestore Pipelines, a Firestore Enterprise edition feature).

actual fun pipeline(): PipelineSource

The sources of pipelines over this database (Firestore Pipelines, a Firestore Enterprise edition feature).

Link copied to clipboard
actual fun runBatch(batchFunction: WriteBatch.Function): Task<Nothing?>

Runs batchFunction on a new WriteBatch and commits it.

actual fun runBatch(batchFunction: WriteBatch.Function): Task<Nothing?>

Runs batchFunction on a new WriteBatch and commits it.

expect fun runBatch(batchFunction: WriteBatch.Function): Task<Nothing?>

Runs batchFunction on a new WriteBatch and commits it.

actual fun runBatch(batchFunction: WriteBatch.Function): Task<Nothing?>

Runs batchFunction on a new WriteBatch and commits it.

actual fun runBatch(batchFunction: WriteBatch.Function): Task<Nothing?>

Runs batchFunction on a new WriteBatch and commits it.

Link copied to clipboard

Runs updateFunction in a transaction, retrying it on contention, and completes with its result.

Runs updateFunction in a transaction with options and completes with its result.

Runs updateFunction in a transaction, retrying it on contention, and completes with its result.

Runs updateFunction in a transaction with options and completes with its result.

Runs updateFunction in a transaction, retrying it on contention, and completes with its result.

Runs updateFunction in a transaction with options and completes with its result.

Runs updateFunction in a transaction, retrying it on contention, and completes with its result.

Runs updateFunction in a transaction with options and completes with its result.

Runs updateFunction in a transaction, retrying it on contention, and completes with its result.

Runs updateFunction in a transaction with options and completes with its result.

Link copied to clipboard
actual fun terminate(): Task<Nothing?>

Terminates the instance; further use fails and a new instance is returned by the accessors.

actual fun terminate(): Task<Nothing?>

Terminates the instance; further use fails and a new instance is returned by the accessors.

expect fun terminate(): Task<Nothing?>

Terminates the instance; further use fails and a new instance is returned by the accessors.

actual fun terminate(): Task<Nothing?>

Terminates the instance; further use fails and a new instance is returned by the accessors.

actual fun terminate(): Task<Nothing?>

Terminates the instance; further use fails and a new instance is returned by the accessors.

Link copied to clipboard
open override fun toString(): String
open override fun toString(): String
open override fun toString(): String
Link copied to clipboard
actual fun useEmulator(host: String, port: Int)

Connects to the Firestore emulator at host:port; must be called before the instance is used.

actual fun useEmulator(host: String, port: Int)

Connects to the Firestore emulator at host:port; must be called before the instance is used.

expect fun useEmulator(host: String, port: Int)

Connects to the Firestore emulator at host:port; must be called before the instance is used.

actual fun useEmulator(host: String, port: Int)

Connects to the Firestore emulator at host:port; must be called before the instance is used.

actual fun useEmulator(host: String, port: Int)

Connects to the Firestore emulator at host:port; must be called before the instance is used.

Link copied to clipboard

Completes when all the pending writes have been acknowledged by the backend.

Completes when all the pending writes have been acknowledged by the backend.

Completes when all the pending writes have been acknowledged by the backend.

Completes when all the pending writes have been acknowledged by the backend.

Completes when all the pending writes have been acknowledged by the backend.