Model

Generated on 2026-09-02 from docs/api/model.md in the repository (commit 47266695abbc of 2026-08-29) by tools/build-api-v3.py. The text is the repository's, not edited here. Known deviations from the published package 3.0.1:

• the import path in the samples is nanook-table; the published package is @xhubio/nanook-table
• tables is a required constructor option of TestcaseProcessor since 2.1.4; the samples assign it after construction

The model module defines the core interfaces and classes that represent tables, test case definitions, and directives. Every table type (decision, matrix, specification) implements these interfaces, and every processor operates on them.

import {
  TableInterface,
  TestcaseDefinitionInterface,
  DirectiveBase,
  StaticDirective,
  GeneratorDirective,
  ReferenceDirective,
  FieldDirective,
  MetaTable,
  MetaTestcase,
  FilterInterface,
  PREFIX_GENERATOR,
  PREFIX_REFERENCE
} from 'nanook-table'

TableInterface

Common interface implemented by all table models (TableDecision, TableMatrix). The processor operates on this interface without knowing the concrete table type.

Properties

Methods

getTestcaseForName(testcaseName: string): TestcaseDefinitionInterface

Returns the test case definition with the given name. Throws an error if no test case with that name exists in the table.

const table: TableInterface = // ... loaded table
const tc = table.getTestcaseForName('tc1')
console.log(tc.testcaseName, tc.execute)

getTestcasesForExecution(): Generator<TestcaseDefinitionInterface>

A generator function that yields all test case definitions that should be executed. Test cases marked with execute = false or neverExecute = true are excluded.

for (const tc of table.getTestcasesForExecution()) {
  console.log(tc.testcaseName)
}

processRanges(testcaseName: string): string[]

Parses a test case name that may contain a range expression and returns an array of individual test case names. For example, 'tc12-14' expands to ['tc12', 'tc13', 'tc14']. If the name is not a range, returns a single-element array.

const names = table.processRanges('tc3-5')
// ['tc3', 'tc4', 'tc5']

TestcaseDefinitionInterface

Interface for a single test case definition within a table. Each column in a decision table or each combination in a matrix table produces one test case definition.

Properties

Methods

createDirectives(): TestcaseDirectivesInterface

Analyzes the test case data and creates all directives needed to generate this test case. This is the primary method that translates spreadsheet cell values into actionable generation instructions.

const directives = testcase.createDirectives()

for (const sd of directives.static) {
  console.log(`Static: ${sd.fieldName} = ${sd.value}`)
}

for (const gd of directives.generator) {
  console.log(`Generator: ${gd.fieldName} -> ${gd.generatorName}`)
}

for (const rd of directives.reference) {
  console.log(`Reference: ${rd.fieldName} -> ${rd.targetTableName}.${rd.targetFieldName}`)
}

createTags(): string[]

Returns all tags defined for this test case. Tags come from TagSection rows in the table and are used for filtering.

const tags = testcase.createTags()
// ['smoke', 'regression', 'login']

createFilter(): FilterInterface[]

Returns all filter definitions for this test case. Each filter has a name and a value expression.

const filters = testcase.createFilter()
for (const f of filters) {
  console.log(`Filter: ${f.filterName} = ${f.filterValue}`)
}

createGeneratorSwitches(): string[]

Returns a list of generator names that should be switched off (not executed) for this test case.

const switches = testcase.createGeneratorSwitches()
// ['generatorPassword'] -- this generator will be skipped

TestcaseDirectivesInterface

The return type of createDirectives(). Groups all directives by type.

interface TestcaseDirectivesInterface {
  generator: GeneratorDirective[]
  static: StaticDirective[]
  reference: ReferenceDirective[]
  field: FieldDirective[]
}

DirectiveBase

Abstract base class for all directive types. Contains the metadata common to every directive.

Properties

StaticDirective

Extends DirectiveBase. Represents a literal value that should be written directly to the test case output without calling a generator.

Properties

In the spreadsheet, any cell value in the generator column that does not start with a recognized prefix (gen: or ref:) is treated as static data.

GeneratorDirective

Extends DirectiveBase. Represents a call to a named data generator. Created when a cell value starts with the gen: prefix.

Properties

Spreadsheet Syntax

gen:<generatorName>(<instanceIdSuffix>):<config>

Examples:

• gen:faker:{"method": "person.firstName"} -- call GeneratorFaker with the given config
• gen:password(pwd):{"minLength": 8} -- call the password generator; uses instance ID suffix pwd

ReferenceDirective

Extends DirectiveBase. Represents a reference to data generated by another table and test case. Created when a cell value starts with the ref: prefix.

Properties

Spreadsheet Syntax

ref:<targetTableName>:<targetFieldName>:<targetTestcaseName>(<instanceIdSuffix>)

FieldDirective

Extends DirectiveBase. Represents a field selection marker. Used internally to track which fields are active in a test case.

Properties

FilterInterface

Defines a filter that can be applied to test cases during processing.

Properties

MetaTable

Metadata about a table's origin.

Properties

MetaTestcase

Metadata about a specific test case. Extends the table metadata with test case identification.

Properties

Constants