OptionaltrackEnable location tracking for tokens.
When enabled, tokens include location with start, end Position objects
and rowNumber. This is useful for error reporting but adds overhead.
Performance impact:
false (default): No location tracking, maximum performancetrue: Full location tracking with Position objectsWhen to enable:
Note: High-level APIs (parseString, etc.) always use trackLocation: false
for performance. This option is only available in low-level Lexer APIs.
// No location tracking (default, fastest)
const lexer = new FlexibleStringCSVLexer();
for (const token of lexer.lex(csv)) {
console.log(token); // { type: Field, value: 'foo' }
}
// With location tracking
const lexer = new FlexibleStringCSVLexer({ trackLocation: true });
for (const token of lexer.lex(csv)) {
console.log(token);
// { type: Field, value: 'foo', location: { start: {...}, end: {...}, rowNumber: 1 } }
}
Options for enabling location tracking in lexer output.