Fires before the JSDO, by means of a saveChanges( ) call following a remove( ) call, sends a request to delete a record in the Data Object resource on the server.
This event fires before each Delete operation request is sent without using Submit, and fires before each one of possibly multiple record deletes are sent with a single Submit operation request.
Note: A single Delete operation request is sent for each record object that you have deleted in the JSDO with a single call to saveChanges( ) or saveChanges(false). A single Submit operation request for any and all created, updated, and deleted JSDO record objects is sent with a single call to saveChanges(true).
The following parameters appear in the signature of any event handler (callback) function (or functions) that you subscribe to this event:
Syntax
function ( jsdo , record , request )
jsdo
A reference to the JSDO that is invoking the delete request. For more information, see the description of jsdo property of the request object.
record
A reference to the table record upon which the delete request is about to act. For more information, see the description of jsrecord property of the request object.
request
A reference to the request object before the delete request is sent. For more information, see the description of request object.
Application code can subscribe a callback to this event by invoking the subscribe( ) method on a JSDO instance or one of its table references.
Example
The following code fragment subscribes the function, onBeforeDelete, to handle the beforeDelete event fired on the JSDO, myjsdo, created for a single-table resource, where myid is the known ID of a record to find and delete:
/* subscribe to event */
myjsdo.subscribe( 'beforeDelete', onBeforeDelete );
/* some code that might delete one or more
records and remove them on the server */
var jsrecord = myjsdo.findById( myid );
if (jsrecord) {jsrecord.remove();};
. . .
myjsdo.saveChanges();
function onBeforeDelete( jsdo , record , request ) {
/* code to execute before sending delete request to the server */