Since: DataTables 1.10

Get the DataTables cached data for the selected cells.


As of v2.0 this feature has been deprecated. This feature has not yet been scheduled for removal, but its use is discouraged and the alternatives discussed below should be used.

Use cells().render() to get the data for a specific rendering type, rather than accessing DataTables' cache. This method will be removed in DataTables 3.


DataTables caches data for searching and ordering in order for those operations to run as quickly as possible when they are required. Sometimes it can be useful to get the data that DataTables has cached for these operations, for example when creating a select list to provide a column based filter.

Cached data is not guaranteed to be available at any particular moment. If DataTables hasn't requested the data, it won't have been cached. This is particularly obvious when using the order option and a sort hasn't been performed on a column. Invalidation of data will also cause the cache to be removed.


function cells().cache( [ type ] )


Get cached data of the cache type specified


DataTables API instance containing the cached data for the selected cells.


The following options are directly related and may also be useful in your application development.