database.RefBuilder class

The Firebase Realtime Database reference builder interface.

Access via [functions.database.ref()](functions.database#.ref).

Signature:

exportdeclareclassRefBuilder<Refextendsstring>

Constructors

ConstructorModifiersDescription
(constructor)(triggerResource, options)Constructs a new instance of theRefBuilder class

Methods

MethodModifiersDescription
onCreate(handler)Event handler that fires every time new data is created in Firebase Realtime Database.
onDelete(handler)Event handler that fires every time data is deleted from Firebase Realtime Database.
onUpdate(handler)Event handler that fires every time data is updated in Firebase Realtime Database.
onWrite(handler)Event handler that fires every time a Firebase Realtime Database write of any kind (creation, update, or delete) occurs.

database.RefBuilder.(constructor)

Constructs a new instance of theRefBuilder class

Signature:

constructor(triggerResource:()=>string,options:DeploymentOptions);

Parameters

ParameterTypeDescription
triggerResource() => string
optionsDeploymentOptions

database.RefBuilder.onCreate()

Event handler that fires every time new data is created in Firebase Realtime Database.

Signature:

onCreate(handler:(snapshot:DataSnapshot,context:EventContext<ParamsOf<Ref>>)=>PromiseLike<any>|any):CloudFunction<DataSnapshot>;

Parameters

ParameterTypeDescription
handler(snapshot:DataSnapshot, context:EventContext<ParamsOf<Ref>>) => PromiseLike<any> | anyEvent handler that runs every time new data is created in Firebase Realtime Database.

Returns:

CloudFunction<DataSnapshot>

A function that you can export and deploy.

database.RefBuilder.onDelete()

Event handler that fires every time data is deleted from Firebase Realtime Database.

Signature:

onDelete(handler:(snapshot:DataSnapshot,context:EventContext<ParamsOf<Ref>>)=>PromiseLike<any>|any):CloudFunction<DataSnapshot>;

Parameters

ParameterTypeDescription
handler(snapshot:DataSnapshot, context:EventContext<ParamsOf<Ref>>) => PromiseLike<any> | anyEvent handler that runs every time data is deleted from Firebase Realtime Database.

Returns:

CloudFunction<DataSnapshot>

A function that you can export and deploy.

database.RefBuilder.onUpdate()

Event handler that fires every time data is updated in Firebase Realtime Database.

Signature:

onUpdate(handler:(change:Change<DataSnapshot>,context:EventContext<ParamsOf<Ref>>)=>PromiseLike<any>|any):CloudFunction<Change<DataSnapshot>>;

Parameters

ParameterTypeDescription
handler(change:Change<DataSnapshot>, context:EventContext<ParamsOf<Ref>>) => PromiseLike<any> | anyEvent handler which is run every time a Firebase Realtime Database write occurs.

Returns:

CloudFunction<Change<DataSnapshot>>

A function which you can export and deploy.

database.RefBuilder.onWrite()

Event handler that fires every time a Firebase Realtime Database write of any kind (creation, update, or delete) occurs.

Signature:

onWrite(handler:(change:Change<DataSnapshot>,context:EventContext<ParamsOf<Ref>>)=>PromiseLike<any>|any):CloudFunction<Change<DataSnapshot>>;

Parameters

ParameterTypeDescription
handler(change:Change<DataSnapshot>, context:EventContext<ParamsOf<Ref>>) => PromiseLike<any> | anyEvent handler that runs every time a Firebase Realtime Database write occurs.

Returns:

CloudFunction<Change<DataSnapshot>>

A function that you can export and deploy.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-04-24 UTC.