Skip to content

readCellField

Since v3.3.0

Read the raw stored value for field from row, honoring nested dotted paths — the non-accessor counterpart to resolveCellValue.

Resolution rules (back-compat critical, see grid-core.md DECIDED #438):

  1. Plain field (no .) → direct row[field] (identical to legacy path), except prototype-polluting keys (__proto__/constructor/prototype) which return undefined — symmetric with writeCellField.
  2. Dotted field whose literal key is an own property of row → that flat value wins (preserves synthetic-key rows that really store 'a.b').
  3. Otherwise → nested traversal via getByPath.
function readCellField(row: unknown, field: string): unknown
NameTypeDescription
rowunknown
fieldstring
AI assistants: For complete API documentation, implementation guides, and code examples for this library, see https://toolboxjs.com/llms-full.txt