Home > @i2analyze/notebook-sdk > app > IApplication > runTrackedMutations
app.IApplication.runTrackedMutations() method
Queues a function that performs tracked mutations on the application contents at the next available opportunity, and can respond to the changes that the mutations cause.
Signature:
runTrackedMutations(mutationHandler: TrackedMutationHandler, responseHandler?: MutationResponseHandler, options?: ITransactionOptions): void;
Introduced: version 1.1
Parameters
| Parameter | Type | Description |
|---|---|---|
| mutationHandler | TrackedMutationHandler | A function that performs one or more tracked mutations and reports on their success as a whole. |
| responseHandler | MutationResponseHandler | (Optional) A callback that receives the changes caused by the mutations. |
| options | ITransactionOptions | (Optional) An object that can control the transaction. |
Returns:
void
Remarks
A mutation is an operation that can read or modify the contents of the application. A successful set of tracked mutations is added as a single entry to the undo stack.