Jest数组断言toEqual()处理空格字符串时异常求助

你遇到的问题本质是视觉上的空白字符≠实际的空白字符，Jest的toEqual是严格字符匹配，哪怕看起来都是空格，只要编码不一样就会断言失败。比如实际返回的可能是全角空格（ASCII 12288）、制表符（ASCII 9）、多个连续空格，甚至是不可见的控制字符，而你预期的是普通半角空格（ASCII 32）。

第一步：排查实际空白字符的真实编码 #

先打印出实际数组中空白元素的字符编码，确认和预期的差异：

// 遍历实际数组，找出空白元素并打印编码
actual.forEach((item, index) => {
  if (item.trim() === '') {
    console.log(`第${index}个空白元素编码:`, item.charCodeAt(0));
  }
});
// 打印预期空格的编码（普通半角空格是32）
console.log('预期空格编码:', ' '.charCodeAt(0));

第二步：根据编码修正断言 #

• 如果实际是全角空格，把预期数组里的" "换成全角空格"　"；
• 如果是多个连续空格，直接改成对应数量的空格；
• 如果是制表符，换成"\t"；

第三步：通用解决方案（忽略空白类型差异） #

如果你的场景只关心元素是空白内容，不纠结具体是哪种空白，可以统一归一化后再断言：

// 把所有空白元素替换成普通半角空格，再做断言
const normalizeArray = arr => arr.map(item => 
  /^\s+$/.test(item) ? ' ' : item
);

expect(normalizeArray(actual)).toEqual(normalizeArray(expected));

或者如果经常遇到这类场景，还可以自定义Jest匹配器，复用逻辑：

// 注册自定义匹配器
expect.extend({
  toMatchArrayIgnoringWhitespace(received, expected) {
    const normalize = arr => arr.map(item => 
      /^\s+$/.test(item) ? ' ' : item
    );
    const normalizedReceived = normalize(received);
    const normalizedExpected = normalize(expected);
    return {
      pass: this.equals(normalizedReceived, normalizedExpected),
      message: () => `数组空白字符不匹配，归一化后实际：${normalizedReceived}，预期：${normalizedExpected}`
    };
  }
});

// 使用自定义匹配器
expect(actual).toMatchArrayIgnoringWhitespace(expected);

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