PapaParse处理空行异常致表头解析错误，原因是什么？

当使用PapaParse并配置header: true时，两段仅末尾是否包含空行的CSV字符串会得到完全不同的解析结果：

测试代码 #

// 带末尾空行的CSV
const csvString2 = "a;b\r\n1;2\r\n3;4\r\n";
const csvArray2 = Papa.parse(csvString2, { header: true }).data;
console.log("csvArray2", csvArray2);

// 无末尾空行的CSV
const csvString3 = "a;b\r\n1;2\r\n3;4";
const csvArray3 = Papa.parse(csvString3, { header: true }).data;
console.log("csvArray3", csvArray3);

引入PapaParse的脚本 #

<script src="https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js" integrity="sha512-dfX5uYVXzyU8+KHqj8bjo7UkOdg18PaOtpa48djpNbZHwExddghZ+ZmzWT06R5v6NSk3ZUfsH6FNEDepLx9hPQ==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>

输出结果 #

csvArray2 [ { 'a;b': '1;2' }, { 'a;b': '3;4' }, { 'a;b': '' } ]
csvArray3 [ { a: '1', b: '2' }, { a: '3', b: '4' } ]

原因解析 #

这是因为PapaParse默认会将末尾的空行视为有效数据行处理，但该行没有分隔符;，导致解析逻辑出现偏差：

• 对于带末尾空行的CSV，解析器会错误判断分隔符不是;，进而将第一行的a;b当作单个表头字段，后续所有行的内容都会被映射到这个错误的字段下，最后还会多出一个空内容的对象。
• 无末尾空行的CSV中，解析器能正常识别第一行的;作为分隔符，正确拆分出a和b两个表头，后续数据行也能正常映射。

解决方案 #

开启skipEmptyLines: true配置后，解析器会自动忽略空行，恢复正常的表头识别和数据映射逻辑：

const csvArray2 = Papa.parse(csvString2, { header: true, skipEmptyLines: true }).data;

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