Events

This section describes events raised by this Data Store object.

To handle events, use one of the following methods.

Attach a handler for a Data Store event
Assign a callback function to the Data Store option that takes on a handler for the required event. The events that can be handled within the Data Store's configuration object are listed in the Configuration section. All these events have names starting with on.
Attach several handlers for one or several events to a Data Store
Specify event handling functions for one or more events using the on() method. All the Data Store events are listed in the Events section.

inserted

Fires after a data item is added.

Event Handler Argument:

values: Object

An object representing the inserted item.

key: Object|String|Number

A key value of the inserted item.

To learn how to handle events, refer to the Events and Change Tracking topic.

inserting

Fires before a data item is added.

Event Handler Argument:

values: Object

An object representing the item being inserted.

To learn how to handle events, refer to the Events and Change Tracking topic.

loaded

Fires after data is loaded.

Event Handler Argument:

result: Array

The loaded data array.

To learn how to handle events, refer to the Events and Change Tracking topic.

loading

Fires before data is loaded.

Event Handler Argument:

loadOptions: Object

An object defining options for the loaded data.

Object structure:

filter: Object

A filter expression for the loaded data.

sort: Object

A sort expression for the loaded data.

select: Object

An expression for selection in the loaded data.

group: Object

An expression for grouping in the loaded data.

skip: Number

The number of items to skip.

take: Number

The number of items to take for the loaded data.

userData: Object

A bag for holding user-defined parameters.

searchValue: Object

The value to which the search expression value is compared.

searchOperation: String

A search operation expression.

searchExpr: getter|Array

A getter representing a search expression.

To learn how to handle events, refer to the Events and Change Tracking topic.

modified

Fires after data is modified.

To learn how to handle events, refer to the Events and Change Tracking topic.

modifying

Fires before the data is modified.

To learn how to handle events, refer to the Events and Change Tracking topic.

removed

Fires after a data item has been removed.

Event Handler Argument:

key: Object|String|Number

A key value of the removed item.

To learn how to handle events, refer to the Events and Change Tracking topic.

removing

Fires before a data item is removed.

Event Handler Argument:

key: Object|String|Number

A key value of the item being removed.

To learn how to handle events, refer to the Events and Change Tracking topic.

updated

Fires after a data item has been updated.

Event Handler Argument:

key: Object|String|Number

A key value of the updated item.

values: Object

New values for the updated item.

To learn how to handle events, refer to the Events and Change Tracking topic.

updating

Fires before a data item is updated.

Event Handler Argument:

key: Object|String|Number

A key value of the item being updated.

values: Object

New values for the item being updated.

To learn how to handle events, refer to the Events and Change Tracking topic.