`getResultCell`

The getResultCell method returns the value of a single ResultCell in a given ResultRow, in the ResultTable of the given query.

getResultCell(
  queryId: Id,
  rowId: Id,
  cellId: Id,
): ResultCellOrUndefined

	Type	Description
`queryId`	`Id`	The `Id` of a query.
`rowId`	`Id`	The `Id` of the `ResultRow` in the `ResultTable`.
`cellId`	`Id`	The `Id` of the `ResultCell` in the `ResultRow`.
returns	`ResultCellOrUndefined`	The value of the `ResultCell`, or `undefined`.

This has the same behavior as a Store's getCell method. For example, if the query, or ResultRow, or ResultCell Id is invalid, the method returns undefined.

Example

This example creates a Queries object, a single query definition, and then calls this method on it (as well as a non-existent ResultCell Id) to get the ResultCell.

const store = createStore().setTable('pets', {
  fido: {species: 'dog', color: 'brown'},
  felix: {species: 'cat', color: 'black'},
  cujo: {species: 'dog', color: 'black'},
});

const queries = createQueries(store).setQueryDefinition(
  'dogColors',
  'pets',
  ({select, where}) => {
    select('color');
    where('species', 'dog');
  },
);

console.log(queries.getResultCell('dogColors', 'fido', 'color'));
// -> 'brown'

console.log(queries.getResultCell('dogColors', 'fido', 'species'));
// -> undefined

Since

v2.0.0