Cheatsheets and messagesMessages
Data, save, and gate messages
Look up the warnings about row data, saves, and async gates, and fix their cause.
Most console warnings print only in a development build, and most print once. A word in angle brackets, such as <id>, stands for a value that the grid fills in. A message that ends in ... continues past the text that the table quotes. The tables leave out the backticks that some messages put around prop names.
Data and row warnings
These warnings come from calls that change or read rows.
| Message | What to do | Page |
|---|---|---|
[data-grid] groupBy needs every row on the client: with totalRowCount or sortMode="server" the grid shows the rows ungrouped | Group on the server, or hold every row and set sortMode to "client". | Query server rows |
[data-grid] groupBy needs loaded rows: while rows are unloaded (a lazy source) the grid shows them ungrouped | Group on the server, or load every row before you set groupBy. | Query server rows |
[data-grid] the aggregate of column "<id>" threw, so its groups show null: <error> | Fix the aggregate function of the column so that it returns a value for every input. | DataGrid props |
[data-grid] expanded holds more than 10,000 group ids, so the grid keeps the first 10,000 | Pass fewer group ids, or use mode: "expanded" and list the groups that stay closed. | DataGrid props |
[data-grid] a client sort or filter changed while data holds unloaded rows or fewer rows than totalRowCount. The client cannot sort or filter rows it has not fetched; use sortMode="server" and filterMode="server" and send the sort and filter to your backend. | Set sortMode and filterMode to "server" and send the sort and filter to your backend. | Query server rows |
[data-grid] totalRowCount makes sorting and filtering server-side by default, and nothing here handles onSortChange or onFilterChange, so the grid will not reorder or narrow its rows. Fetch rows for the spec, or set sortMode="client" and filterMode="client" to work on the loaded rows | Handle onSortChange and onFilterChange and fetch rows for the spec, or set sortMode="client" and filterMode="client". | Data mode guide |
[data-grid] the sort changed, but sortMode is "server" (totalRowCount sets it by default) and nothing handles onSortChange, so no request carries it and the rows keep their order. Pass onSortChange and sortState to your fetch, or set sortMode="client" | Handle onSortChange and send sortState with the request, or set sortMode="client". | Data mode guide |
[data-grid] the filters changed, but filterMode is "server" (totalRowCount sets it by default) and nothing handles onFilterChange, so no request carries them and the rows stay. Pass onFilterChange and filterState to your fetch, or set filterMode="client" | Handle onFilterChange and send filterState with the request, or set filterMode="client". | Data mode guide |
[data-grid] an onSave answer listed more than 10000 rejections, so the grid refuses every row of that change. Send at most 10000 rejections, or reject with an error | Send at most 10,000 entries in rejected, or reject the promise to refuse the whole change. | Handle refused saves |
[data-grid] onRowActionSkipped threw: <error> | Catch the error inside onRowActionSkipped. The grid logs it as a console error and goes on. | Handle row action results |
[data-grid] reorderRows is a no-op while a sort or filter is active (the view order is owned by them) | Clear the sort and the filter before you move rows. | Row order |
[data-grid] reorderRows is a no-op while rows are still unloaded (scroll mode): load the range first | Load the rows of the range first. | Row order |
[data-grid] <operation> is a no-op while its target rows are still unloaded (scroll mode): load the range first, or delete known ids with deleteRows | Load the rows of the range first, or delete known ids with deleteRows. The action returns the reason "unloaded-rows". | Handle row action results |
[data-grid] deleteRows skips the target rows that are still unloaded (scroll mode) and deletes the loaded ones | Load the rows of the range first, or delete known ids. onRowActionSkipped reports the skipped count. | Handle row action results |
[data-grid] insertRows: count must be an integer (got <count>) | Pass a whole number as count. | Row operations |
[data-grid] row insertion is a no-op because no createRow prop was provided | Pass createRow to enable row insertion. | Row operations |
[data-grid] duplicateRows is a no-op because no duplicateRow prop was provided | Pass duplicateRow to enable row duplication. | Row operations |
[data-grid] CellRef { rowId: <rowId>, columnId: <columnId> } does not resolve in the current view (row no longer in data, or column hidden); the action is a no-op | Pass a row id that is in the view and a column that is not hidden. | State and view index |
[data-grid] a controlled selection value names rows, columns, or range corners that no longer resolve (a row left the data, a column is hidden); the resolvable subset was applied | Update your selection state when rows leave the data or columns hide. | Selection and cell events |
[data-grid] onDataChange threw: | Fix the error in onDataChange. The grid prints the error after the text, and onSave and the plugin observers still run. This one is a console error. | Event shapes |
[data-grid] <message> <error> | A consumer callback of the write path threw: onSaveRejected, resolveSaveConflict, a plugin observer, or a queued emit. Fix the error in the callback. The page also gets the error through reportError where the browser has it, and the grid goes on. | Event shapes |
[data-grid] a plugin onDataChange observer threw; the change was applied and the remaining observers still run | Fix the error in the plugin. The grid prints the error object after the text. | Plugin events |
[data-grid] <action> takes stable row ids, and a number here is not a row id. To address rows by view index, call <action>At | Pass row ids, or call the At form of the action with view row numbers. | Row operations |
[data-grid] a cell type's fromText threw; the cell is rejected. Call rejectText() in fromText to refuse text without this warning. | Call rejectText() in fromText for text it cannot parse. The cell keeps its value, and the grid keeps the rest of the paste, fill, import, or replace. | CellType contract |
Save warnings and errors
These messages come from onSave and onSaveRejected.
| Message | What to do | Page |
|---|---|---|
[data-grid] SaveRejection.current for row "<rowId>" has another id, so it was ignored and the change was reverted in place | Return the current row with the same row id in current. | Handle refused saves |
[data-grid] the revert of a refused save threw in a callback: | Fix the callback that the revert calls. The grid prints the error after the text. This one is a console error. | Handle refused saves |
[data-grid] onSaveRejected threw: | Fix the error in onSaveRejected. The grid prints the error after the text. This one is a console error. | Data change events |
[data-grid] resolveSaveConflict threw, so the server's row is taken: | Fix the error in resolveSaveConflict. The grid prints the error after the text. This one is a console error. | Handle refused saves |
[data-grid] resolveSaveConflict rejected, so the server's row is taken: | Fix the promise that resolveSaveConflict returns. The grid prints the error after the text. This one is a console error. | Handle refused saves |
[data-grid] resolveSaveConflict returned a row that does not have the id "<rowId>", so the server's row is taken | Return { row } with the id of the refused row. | Handle refused saves |
[data-grid] replaceRowId: no row has the id "<oldId>", or it is swapped twice, so that swap was skipped | Pass the id of a row in data, and swap each id once. | Save edits |
[data-grid] replaceRowId: getRowId threw for the new row, so that swap was skipped | Fix getRowId, or pass a new row that has an id. | Save edits |
[data-grid] replaceRowId: another row already has the id "<newId>", so that swap was skipped | Give the new row an id that no other row has. | Save edits |
[data-grid] the merge of a save conflict threw in a callback: | Fix the callback that the merge calls, such as onDataChange or onSave. The grid prints the error after the text. This one is a console error. | Handle refused saves |
[data-grid] the revert of a refused save failed: | Fix the callback that the revert calls. The grid prints the error after the text. This one is a console error. | Handle refused saves |
[data-grid] a "stream" call takes at most <max> patches; the <n> after them skip with reason "limit". Send smaller batches | Split the batch of updateCells or updateRows into calls of at most 100,000 patches. | Push live values |
[data-grid] a "stream" call takes at most <max> patches or row ids; the <n> after them are skipped. Send smaller batches | Split the list of deleteRows into calls of at most 100,000 ids. | Push into a server-ordered view |
[data-grid] reorder: "immediate" on a server sort or filter marks the rows stale and asks useDataGridServerRows to place them again, but no such hook is mounted; refetch the rows yourself | Use useDataGridServerRows, or refetch the rows yourself after a push. | Push into a server-ordered view |
[data-grid] incremental view index diverged from the full rebuild; using the rebuild. Please report this with the sort/filter state. | Report the sort and filter state as a bug. The grid uses the full rebuild. This one is a console error. | State and view index |
Gate warnings
These warnings come from gates that return a promise. The grid prints each one once per grid.
| Message | What to do | Page |
|---|---|---|
[data-grid] validateRow rejected, so the row gets no verdict: <error> | Fix the error in validateRow, or catch it inside the function. | Validation |
[data-grid] <gate> has not settled after 30 seconds and gateTimeoutMs is not set, so the grid keeps waiting; settle the promise on every path, or set gateTimeoutMs | Settle the promise on every path, or set gateTimeoutMs. | Gate cancellation and timeouts |
[data-grid] onBeforeEditStart rejected, so the edit does not start: <error> | Fix the error in onBeforeEditStart, or catch it inside the function. | Gate cancellation and timeouts |
[data-grid] validateRow threw, so the row gets no verdict: <error> | Fix the error in validateRow, or catch it inside the function. The write stays. | Row validation and async checks |
[data-grid] createRow rejected, so the insert is cancelled: <error> | Fix the error in createRow, or catch it inside the function. | Row operations |
[data-grid] duplicateRow rejected, so the duplicate is cancelled: <error> | Fix the error in duplicateRow, or catch it inside the function. | Row operations |
[data-grid] onBeforeDeleteRows threw, so the delete is cancelled: <error> | Fix the error in onBeforeDeleteRows. The action returns the reason "gate-threw". | Row operations |
[data-grid] onBeforeDeleteRows rejected, so the delete is cancelled: <error> | Fix the promise that onBeforeDeleteRows returns, or resolve it with false to decline. | Row operations |
Related
- Message index: all message pages
- Labels and i18n: change the text the grid shows
- Troubleshoot server data: fix a server data problem