Skip to content

Unconditional Delivery Listeners

The where clause argument in the addUpdateListener method is optional. When it is not provided, the real-time database will deliver any object  which is being updated in the database's table:

const orderEventHandler = Backendless.Data.of('Order').rt();

const onObjectUpdate = object => 
                       console.log( 'an Order object has been updated. Object ID - ', object.objectId );

const onError = error => 
                console.log( 'An error has occurred -', error );

orderEventHandler.addUpdateListener( onObjectUpdate, onError );
function Order() {
  this.objectId = undefined;
  this.orderAmount = 0;
}

const orderEventHandler = Backendless.Data.of( Order ).rt();

const onObjectUpdate = object => 
                       console.log( 'an Order object has been updated. Object ID - ', object.objectId );

const onError = error => 
                console.log( 'An error has occurred -', error );

orderEventHandler.addUpdateListener( onObjectUpdate, onError );

Codeless Reference

rt_update_listener_1

where:

Argument                Description
id Unique identifier of the new event listener.
table name The name of the data table where a conditional event listener must be registered.
where clause Optional parameter. Sets the condition for an event listener which gets triggered every time the condition is met when the update operation is invoked for a specific data table. For more information about the where clause syntax, see the Condition Syntax section of the guide.
object When a listener gets triggered, the Backendless delivers a callback object containing the updated object to the listener.

The example below registers a new event listener for the "Person" data table with the id``"1EFD-3GEF2-FF4C-AC21". The listener is triggered when an existing object is updated in the data table.

Assume an object in the data table is updated, and the Codeless logic below executes a custom block of code; First the following sentence is printed: "Update operation has triggered the listener.", then the value of the property objectId is retrieved from the object variable and also gets printed.

rt_update_listener_unconditional_1