Ir para o console

Executar funções localmente

A Firebase CLI inclui um emulador do Cloud Functions que pode simular os seguintes tipos de função:

  • Funções HTTPS
  • Funções chamáveis
  • Funções do Cloud Firestore

Execute funções localmente para testá-las antes da implantação na produção.

Instalar a Firebase CLI

Para usar o emulador do Cloud Functions, primeiro instale a Firebase CLI:

npm install -g firebase-tools

Para usar o emulador local, suas funções do Cloud Functions precisam dos requisitos a seguir:

  • firebase-admin versão 7.0.0 ou superior.
  • firebase-functions versão 2.0.0 ou superior.

Configurar credenciais de administrador (opcional)

Se você quiser que seus testes de funções interajam com outras APIs do Firebase e do Google por meio do SDK Admin do Firebase, talvez seja necessário configurar credenciais de administrador.

  • Os acionadores do Cloud Firestore e do Realtime Database já têm as credenciais necessárias e não requerem configuração adicional.
  • Para todas as outras APIs, incluindo as APIs do Firebase (como Authentication e FCM) ou APIs do Google (como a Cloud Translation ou Cloud Speech), será necessário concluir as etapas de configuração descritas nesta seção. Isso se aplicará se você estiver usando o shell do Functions ou o firebase serve.

Se quiser configurar credenciais de administrador para funções emuladas:

  1. Abra o painel de contas de serviço do Console do Google Cloud.
  2. Verifique se a conta de serviço padrão do App Engine está selecionada e use o menu de opções à direita para selecionar Criar chave.
  3. Quando solicitado, selecione JSON para o tipo de chave e clique em Criar.
  4. Defina suas credenciais padrão do Google para apontar para a chave salva:

    Unix

    $ export GOOGLE_APPLICATION_CREDENTIALS="path/to/key.json"
    
    $ firebase emulators:start
    

    Windows

    $ set GOOGLE_APPLICATION_CREDENTIALS=path\to\key.json
    
    $ firebase emulators:start
    

Depois de concluir essas etapas, seus testes de funções poderão acessar as APIs do Firebase e do Google usando o SDK Admin. Por exemplo, ao testar um acionador do Authentication, a função emulada poderá chamar admin.auth().getUserByEmail(email).

Execute o pacote do emulador

Para executar o emulador Cloud Functions, use o comando emulators:start:

firebase emulators:start

O comando emulators:start iniciará os emuladores para o Cloud Functions, Cloud Firestore, Realtime Database e Firebase Hosting com base nos produtos que você inicializou emno seu projeto local usando firebase init. Se você quer iniciar um emulador específico, use a sinalização --only:

firebase emulators:start --only functions

Se você quer executar um conjunto de testes ou um script de teste após a inicialização dos emuladores, use o comando emulators:exec:

firebase emulators:exec "./my-test.sh"

Interações com outros serviços

O conjunto inclui vários emuladores, que permitem o teste de interações entre produtos.

Cloud Firestore

Se você tiver funções do Cloud Functions que usam o SDK Admin do Firebase para gravar no Cloud Firestore, essas gravações serão enviadas ao emulador do Cloud Firestore, se estiverem em execução. Se mais funções da nuvem forem acionadas por essas gravações, elas serão executadas no emulador do Cloud Functions.

Firebase Hosting

Se você usa o Cloud Functions para gerar conteúdo dinâmico para o Firebase Hosting, firebase emulators:start usa suas funções HTTP locais como proxies para hospedagem.

Geração de registros

O emulador transmite registros de suas funções para a janela do terminal em que eles são executados. Todas as saídas de instrução de console.log(), console.info(), console.error() e console.warn() são exibidas dentro das suas funções.

Próximas etapas

Para um exemplo completo sobre como usar o conjunto de emuladores do Firebase, consulte a Amostra de início rápido.