Appframe Data for modern browsers
An implementation of afDataObject using modern browser APIs and syntax. The bundle also includes the Api, DataProviderHandler, MemoryStorage and Procedure classes.
This project provides 2 versions of the data object. One version that should have the same API as afDataObject (but might not be compatible), and one slightly more lightweight version.
The light version removes some of the less used methods:
- getGroupBy / setGroupBy
Functions that takes callbacks are now simple wrappers around equivalent async functions. The async functions are preferred over functions with callbacks, and the callback functions might be deprecated/removed in the future. The async versions do not use the errorHandler, but will isntead throw errors.
Async methods in DataObject:
Async methods in DataHandler:
Async methods in Procedure
- Abortable events may now return a promise. If it resolves to
false, the action will be cancelled.
- These properties are public on the data object
- Options (dataObject.options)
- Data handler (dataObject.dataHandler)
- Event handler (dataObject.eventHandler)
- storageEngine (dataObject.storageEngine)
- masterDataObject (dataObject.masterDataObject)
setCurrentIndexare now async (due to supporting promises in abortable events)
endEditno longer support running synchronously by passing a synchronous boolean parameter.
setCurrentIndexstill supports a second boolean parameter, but this will not cause it to run synchronously, but instead only await the save call if it is true.
The following APIs need to be polyfilled in order to use this project with older browsers, e.g. IE 11:
- fetch + AbortController
With even more polyfills, the project might be usable in older browsers than IE11, but if you need to support those, you might be better off with the original afDataOBject.