Se usó la API de Cloud Translation para traducir esta página.

Usa el emulador de Firestore de manera local

Google Cloud CLI proporciona un emulador local en la memoria para Firestore que puedes usar a fin de probar la aplicación. Puedes usar el emulador con todas las bibliotecas cliente de Firestore. Solo debes usar el emulador para pruebas locales.

No uses el emulador para implementaciones de producción. Debido a que el emulador almacena datos solo en la memoria, no conservará datos entre ejecuciones.

Instala el emulador

Para instalar el emulador de Firestore, instala y actualiza la gcloud CLI:

Instala la CLI de gcloud.
Actualiza la instalación de gcloud CLI para obtener las funciones más recientes:
```
gcloud components update
```

Ejecuta el emulador

Ejecuta el siguiente comando para iniciar el emulador
```
gcloud emulators firestore start
```
El emulador imprime el host y el número de puerto donde se esté ejecutando.

De forma predeterminada, el emulador intenta usar 127.0.0.1:8080. Para vincular el emulador a un host y un puerto específicos, usa la marca opcional --host-port y reemplaza HOST y PORT:
```
gcloud emulators firestore start --host-port=HOST:PORT
```
Escribe Control + C para detener el emulador. El emulador también se puede detener con una solicitud POST a /shutdown. Por ejemplo:
```
curl -d '' HOST:PORT/shutdown
```

Conectarse al emulador

La forma de conectarte al emulador depende del tipo de biblioteca cliente, biblioteca cliente del servidor o SDK web o para dispositivos móviles.

Bibliotecas cliente del servidor

Para conectar una biblioteca cliente del servidor de Firestore (C#, Go, Java, Node.js, PHP, Python y Ruby), configura la variable de entorno FIRESTORE_EMULATOR_HOST. Cuando se configura esta variable de entorno, las bibliotecas cliente del servidor se conectan automáticamente al emulador.

export FIRESTORE_EMULATOR_HOST="HOST:PORT"

SDK para plataformas de Android y Apple y para la Web

En los siguientes ejemplos, se muestra cómo conectar los SDKs de Android, las plataformas de Apple y la Web al emulador de Firestore:

Android

// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseFirestore firestore = FirebaseFirestore.getInstance();
firestore.useEmulator("10.0.2.2", 8080);

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
firestore.setFirestoreSettings(settings);EmulatorSuite.java

Swift

let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settingsViewController.swift

Web versión 9

import { getFirestore, connectFirestoreEmulator } from "firebase/firestore";

// firebaseApps previously initialized using initializeApp()
const db = getFirestore();
connectFirestoreEmulator(db, '127.0.0.1', 8080);fs_emulator_connect.js

Web versión 8

// Firebase previously initialized using firebase.initializeApp().
var db = firebase.firestore();
if (location.hostname === "localhost") {
  db.useEmulator("127.0.0.1", 8080);
}emulator-suite.js

El emulador de Firestore borra el contenido de la base de datos cuando se cierra. Dado que la caché sin conexión del SDK de Firestore no se borra automáticamente, te recomendamos inhabilitar la persistencia local en la configuración del emulador para evitar discrepancias entre la base de datos emulada y las cachés locales. En el caso del SDK web, la persistencia está inhabilitada de forma predeterminada.

Borra los datos del emulador

El emulador de Firestore incluye un extremo de REST para borrar todos los datos que se encuentran actualmente en el emulador. Puedes usar este extremo para borrar los datos entre pruebas sin cerrar el emulador.

Para borrar todos los datos del emulador, realiza una operación HTTP DELETE con el siguiente extremo. Para ello, reemplaza HOST y PORT por el host y el puerto que seleccionaste, y PROJECT_ID por el ID de tu proyecto:

http://HOST:PORT/emulator/v1/projects/PROJECT_ID/databases/(default)/documents

Ajusta el host y el puerto si el emulador no usa 127.0.0.1:8080. Tu código debe esperar la confirmación de REST de que la eliminación finalizó o falló.

Puedes realizar esta operación desde la shell mediante curl:

$ curl -v -X DELETE "http://HOST:PORT/emulator/v1/projects/PROJECT_ID/databases/(default)/documents"

Diferencias entre el emulador de Firestore y el entorno de producción

El emulador de Firestore intenta replicar fielmente el comportamiento del servicio de producción, salvo algunas limitaciones notables.

Transacciones

El emulador no implementa todos los comportamientos de transacciones que se ven en producción. Cuando pruebas funciones que implican varias escrituras simultáneas en un documento, es posible que el emulador tarde en completar las solicitudes de escritura. En algunos casos, los bloqueos pueden tardar hasta 30 segundos en liberarse. Te recomendamos ajustar los tiempos de espera de la prueba según sea necesario.

Índices

El emulador no realiza un seguimiento de los índices compuestos y, en su lugar, ejecutará cualquier consulta válida. Asegúrate de probar tu app con una instancia real de Firestore para determinar qué índices necesitas.

Límites

El emulador no aplica todos los límites que se implementan en producción. Por ejemplo, es posible que el emulador permita transacciones que el servicio de producción rechazaría debido a su gran tamaño. Asegúrate de conocer los límites documentados y de diseñar tu app para evitarlos de forma proactiva.