firebase-functions-test

Firebase Test SDK for Cloud Functions

The firebase-functions-test is unit testing library for Cloud Functions for Firebase. It is a companion to firebase-functions.

NOTE: This library can only be used with firebase-functions v3.20.1 or above.

Usage

• Write some Firebase Functions
• With your testing framework of choice, write a unit-test that imports your Firebase Functions.
• wrap your Firebase Functions. You can invoke the Firebase Function's handler by invoking the wrap call.

Eg.

import {myFirebaseFunction} from "../index"; // Your Firebase Functions
import firebaseFunctionsTest from "firebase-functions-test";

// Extracting `wrap` out of the lazy-loaded features
const {wrap} = firebaseFunctionsTest();

// `jest-ts` example
test('my unit test', () => {
  const wrappedFirebaseFunction = wrap(myFirebaseFunction);

  // Invoke the firebase function
  wrappedFirebaseFunction();

  // Invoke the firebase function with CloudEvent overrides
  wrappedFirebaseFunction({data: {arbitrary: 'values'}});
});

Examples

• Unit Testing Gen-1 Cloud Functions using Mocha
• Unit Testing Gen-2 Cloud Functions using Mocha
• Unit Testing Gen-2 Cloud Functions using Jest
• Unit Testing Gen-2 Cloud Functions using Jest-Ts

Learn more

Learn more about unit testing Cloud Functions here.

Contributing

To contribute a change, check out the contributing guide.

License

© Google, 2018. Licensed under The MIT License.

Similar packages

Other packages similar to firebase-functions-test

mocha

Mocha is a feature-rich JavaScript test framework running on Node.js and in the browser, making asynchronous testing simple and fun. While it is not specific to Firebase, it can be used in conjunction with other libraries to test Firebase functions.

jest

Jest is a delightful JavaScript Testing Framework with a focus on simplicity. It works with projects using Babel, TypeScript, Node.js, React, Angular, Vue.js, and Svelte. Jest can be used to test Firebase functions but requires additional setup for mocking Firebase services.

sinon

Sinon is a standalone test spies, stubs, and mocks for JavaScript. It works with any unit testing framework. While Sinon is not specific to Firebase, it is often used to mock Firebase services in tests.