如何触发fast-csv解析错误并验证错误处理逻辑

问题描述 #

我已成功运行fast-csv的快速示例，示例代码如下：

import * as fs from 'fs';
import * as path from 'path';
import * as csv from 'fast-csv';

fs.createReadStream(path.resolve(__dirname, 'assets', 'parse.csv'))
    .pipe(csv.parse({ headers: true }))
    .on('error', error => console.error(error))
    .on('data', row => console.log(row))
    .on('end', (rowCount: number) => console.log(`Parsed ${rowCount} rows`));

尝试解析非CSV文件来触发错误，但并未成功。想知道如何触发错误条件，用于自动化测试模拟错误，确保错误处理逻辑正常工作。

解决方法 #

以下是几种可靠触发fast-csv错误的场景，适配自动化测试需求：

1. 构造格式冲突的坏CSV数据 #

普通纯文本文件可能不会触发解析错误，fast-csv会尝试按行解析成对象。需要构造格式冲突的内容：

• 开启headers: true时，某一行字段数量与表头不一致
• 包含未闭合的引号

示例坏数据文件bad.csv内容：

name,age
Alice,30
Bob,25,extra-field
Charlie,"unclosed-quote

用该文件作为输入流，会直接触发解析错误。

2. 模拟流层面错误 #

如果要测试流读取失败的场景，无需真实文件，直接创建一个会抛出错误的可读流：

import { Readable } from 'stream';
import * as csv from 'fast-csv';

// 创建模拟错误的可读流
const errorStream = new Readable({
    read() {
        this.emit('error', new Error('Simulated stream error'));
    }
});

errorStream
    .pipe(csv.parse({ headers: true }))
    .on('error', error => {
        console.error(error); // 捕获到模拟错误
        // 在此处添加测试断言逻辑
    });

3. 开启严格解析模式 #

启用fast-csv的严格解析选项，让格式不规范的内容直接触发错误，而非跳过：

fs.createReadStream(path.resolve(__dirname, 'assets', 'non-standard.csv'))
    .pipe(csv.parse({ 
        headers: true,
        strict: true, // 开启严格模式
        skipInvalidRows: false // 禁止跳过无效行
    }))
    .on('error', error => console.error(error))
    .on('data', row => console.log(row))
    .on('end', (rowCount: number) => console.log(`Parsed ${rowCount} rows`));

比如当某行字段数与表头不匹配时，严格模式会立即抛出错误。

4. 使用内存中的坏数据（无物理文件） #

自动化测试中，直接用内存字符串创建可读流更高效：

import { Readable } from 'stream';
import * as csv from 'fast-csv';

// 构造带格式错误的CSV字符串
const badCsvData = `name,age
Alice,30
Bob,25,extra`;

const stream = Readable.from([badCsvData]);

stream
    .pipe(csv.parse({ headers: true, strict: true }))
    .on('error', error => {
        console.error(error); // 捕获字段不匹配错误
        // 添加测试断言逻辑
    });

内容的提问来源于stack exchange，提问作者Jeff