error-handling.md

Error Handling

In the formatting process, there may be two types of errors.

• Syntax errors.
• Pipe errors.

Syntax Errors

Syntax errors are always thrown. The following templates are invalid.

import { format } from '@fluentfixture/format';

format('${name:}', {}); // missing transformers.
format('${name:padStart}', {}); // missing parameters.
format('${padStart()}', {}); // missing semicolon at the index 0.
format("${:split(',')}", {}); // single quotes are not supported.

Pipe Errors

Pipe errors occur while invoking a pipe function. By default, these kinds of errors are handled by the library.

With IgnoreErrors Flag (Default)

import { Formatter, Pipes } from '@fluentfixture/format';

const formatter = Formatter.create(Pipes.withDefaults(), { ignoreErrors: true });

formatter.format('ITEMS = ${items:join("+")}', { });
// ITEMS = 

Without IgnoreErrors Flag

import { Formatter, Pipes } from '@fluentfixture/format';

const formatter = Formatter.create(Pipes.withDefaults(), { ignoreErrors: false });

formatter.format('ITEMS = ${items:join("+")}', { });
// TypeError: Cannot read properties of undefined (reading 'join')