• Version 0.11.1
  • Published
  • 430 kB
  • 7 dependencies
  • Apache-2.0 license


npm i @firebase/functions
yarn add @firebase/functions
pnpm add @firebase/functions


Cloud Functions for Firebase



function connectFunctionsEmulator

connectFunctionsEmulator: (
functionsInstance: Functions,
host: string,
port: number
) => void;
  • Modify this instance to communicate with the Cloud Functions emulator.

    Note: this must be called before this instance has been used to do any operations.

    Parameter host

    The emulator host (ex: localhost)

    Parameter port

    The emulator port (ex: 5001)


    • @public

function getFunctions

getFunctions: (app?: FirebaseApp, regionOrCustomDomain?: string) => Functions;
  • Returns a Functions instance for the given app.

    Parameter app

    The @firebase/app#FirebaseApp to use.

    Parameter regionOrCustomDomain

    one of: a) The region the callable functions are located in (ex: us-central1) b) A custom domain hosting the callable functions (ex: https://mydomain.com)


    • @public

function httpsCallable

httpsCallable: <RequestData = unknown, ResponseData = unknown>(
functionsInstance: Functions,
name: string,
options?: HttpsCallableOptions
) => HttpsCallable<RequestData, ResponseData>;
  • Returns a reference to the callable HTTPS trigger with the given name.

    Parameter name

    The name of the trigger.


    • @public

function httpsCallableFromURL

httpsCallableFromURL: <RequestData = unknown, ResponseData = unknown>(
functionsInstance: Functions,
url: string,
options?: HttpsCallableOptions
) => HttpsCallable<RequestData, ResponseData>;
  • Returns a reference to the callable HTTPS trigger with the specified url.

    Parameter url

    The url of the trigger.


    • @public


interface Functions

interface Functions {}
  • A Functions instance.


    • @public

property app

app: FirebaseApp;

property customDomain

customDomain: string | null;
  • A custom domain hosting the callable Cloud Functions. ex: https://mydomain.com

property region

region: string;
  • The region the callable Cloud Functions are located in. Default is us-central-1.

interface FunctionsError

interface FunctionsError extends FirebaseError {}
  • An error returned by the Firebase Functions client SDK.


    • @public

property code

readonly code: FunctionsErrorCode;
  • A standard error code that will be returned to the client. This also determines the HTTP status code of the response, as defined in code.proto.

property details

readonly details?: unknown;
  • Extra data to be converted to JSON and included in the error response.

interface HttpsCallableOptions

interface HttpsCallableOptions {}
  • An interface for metadata about how calls should be executed.


    • @public

property limitedUseAppCheckTokens

limitedUseAppCheckTokens?: boolean;
  • If set to true, uses limited-use App Check token for callable function requests from this instance of Functions. You must use limited-use tokens to call functions with replay protection enabled. By default, this is false.

property timeout

timeout?: number;
  • Time in milliseconds after which to cancel if there is no response. Default is 70000.

interface HttpsCallableResult

interface HttpsCallableResult<ResponseData = unknown> {}
  • An HttpsCallableResult wraps a single result from a function call.


    • @public

property data

readonly data: ResponseData;
  • Data returned from callable function.

Type Aliases

type FunctionsErrorCode

type FunctionsErrorCode = `functions/${FunctionsErrorCodeCore}`;
  • The set of Firebase Functions status codes. The codes are the same at the ones exposed by gRPC here: https://github.com/grpc/grpc/blob/master/doc/statuscodes.md

    Possible values: - 'cancelled': The operation was cancelled (typically by the caller). - 'unknown': Unknown error or an error from a different error domain. - 'invalid-argument': Client specified an invalid argument. Note that this differs from 'failed-precondition'. 'invalid-argument' indicates arguments that are problematic regardless of the state of the system (e.g. an invalid field name). - 'deadline-exceeded': Deadline expired before operation could complete. For operations that change the state of the system, this error may be returned even if the operation has completed successfully. For example, a successful response from a server could have been delayed long enough for the deadline to expire. - 'not-found': Some requested document was not found. - 'already-exists': Some document that we attempted to create already exists. - 'permission-denied': The caller does not have permission to execute the specified operation. - 'resource-exhausted': Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space. - 'failed-precondition': Operation was rejected because the system is not in a state required for the operation's execution. - 'aborted': The operation was aborted, typically due to a concurrency issue like transaction aborts, etc. - 'out-of-range': Operation was attempted past the valid range. - 'unimplemented': Operation is not implemented or not supported/enabled. - 'internal': Internal errors. Means some invariants expected by underlying system has been broken. If you see one of these errors, something is very broken. - 'unavailable': The service is currently unavailable. This is most likely a transient condition and may be corrected by retrying with a backoff. - 'data-loss': Unrecoverable data loss or corruption. - 'unauthenticated': The request does not have valid authentication credentials for the operation.


    • @public

type FunctionsErrorCodeCore

type FunctionsErrorCodeCore =
| 'ok'
| 'cancelled'
| 'unknown'
| 'invalid-argument'
| 'deadline-exceeded'
| 'not-found'
| 'already-exists'
| 'permission-denied'
| 'resource-exhausted'
| 'failed-precondition'
| 'aborted'
| 'out-of-range'
| 'unimplemented'
| 'internal'
| 'unavailable'
| 'data-loss'
| 'unauthenticated';
  • Functions error code string appended after "functions/" product prefix. See FunctionsErrorCode for full documentation of codes.


    • @public

type HttpsCallable

type HttpsCallable<RequestData = unknown, ResponseData = unknown> = (
data?: RequestData | null
) => Promise<HttpsCallableResult<ResponseData>>;
  • A reference to a "callable" HTTP trigger in Google Cloud Functions.

    Parameter data

    Data to be passed to callable function.


    • @public

Package Files (1)

Dependencies (7)

Dev Dependencies (5)

Peer Dependencies (1)


To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@firebase/functions.

  • Markdown
  • HTML
    <a href="https://www.jsdocs.io/package/@firebase/functions"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>