Function replaceData

handsontable/src/dataMap/replaceData.ts:85–174

* Loads new data to Handsontable. * * @private * @param {Array} data Array of arrays or array of objects containing data. * @param {Function} setDataMapFunction Function that updates the datamap instance. * @param {Function} callbackFunction Function that takes care of updating Handsontable to

(
  data: unknown[],
  setDataMapFunction: (dataMap: DataMap) => void,
  callbackFunction: (dataMap: DataMap) => void,
  config: ReplaceDataConfig
)

 * @fires Hooks#afterChange
 */
function replaceData(
  data: unknown[],
  setDataMapFunction: (dataMap: DataMap) => void,
  callbackFunction: (dataMap: DataMap) => void,
  config: ReplaceDataConfig
) {
  const {
    hotInstance,
    dataMap,
    dataSource,
    internalSource,
    source,
    metaManager,
    firstRun
  } = config;
  const capitalizedInternalSource = toUpperCaseFirst(internalSource);
  const tableMeta = hotInstance.getSettings();

  if (Array.isArray(tableMeta.dataSchema)) {
    hotInstance.dataType = 'array';
  } else if (isFunction(tableMeta.dataSchema)) {
    hotInstance.dataType = 'function';
  } else {
    hotInstance.dataType = 'object';
  }

  if (dataMap) {
    dataMap.destroy();
  }

  data = hotInstance.runHooks(`before${capitalizedInternalSource}`, data, firstRun, source) as unknown[];

  const newDataMap = new DataMap(hotInstance, data as (Record<string, unknown> | unknown[])[], metaManager);

  // We need to apply the new dataMap immediately, because of some asynchronous logic in the
  // `autoRowSize`/`autoColumnSize` plugins.
  setDataMapFunction(newDataMap);

  if (typeof data === 'object' && data !== null) {
    if (!((data as unknown[]).push && (data as unknown[]).splice)) { // check if data is array. Must use duck-type check so Backbone Collections also pass it
      // when data is not an array, attempt to make a single-row array of it
      // eslint-disable-next-line no-param-reassign
      data = [data];
    }

  } else if (data === null) {
    // eslint-disable-next-line no-param-reassign
    data = buildNullData(hotInstance, newDataMap, tableMeta);

  } else {
    throwWithCause(`${internalSource} only accepts array of objects or array of arrays (${typeof data} given)`);
  }

  if (Array.isArray((data as unknown[])[0])) {
    hotInstance.dataType = 'array';
  }

  tableMeta.data = data as unknown[][] | object[];