API单元测试中，如何用Jest判断字符串能否被JSON.parse合法解析？

你遇到的这个问题很常见——直接用JSON.parse()如果碰到非JSON格式的字符串，会直接抛出语法错误，导致测试直接崩溃，而不是按照预期标记为失败。下面给你两种实用的解决思路：

方法一：封装一个可复用的JSON校验函数 #

先写一个辅助函数，专门用来判断字符串是否能被合法解析为JSON：

function isJsonParsable(str: string): boolean {
  try {
    JSON.parse(str);
    return true;
  } catch (e) {
    return false;
  }
}

然后在你的测试用例里，先校验字符串的合法性，再进行后续断言：

test('API返回合法JSON且包含error字段', () => {
  // 第一步：验证字符串可被解析为JSON
  expect(isJsonParsable(body)).toBe(true);
  
  // 第二步：解析后断言目标属性存在
  const apiResponse: object = JSON.parse(body);
  expect(apiResponse).toHaveProperty('error');
});

这样如果body不是合法JSON，第一个断言就会失败，测试结果会清晰显示“expected true but received false”，而不是抛出一堆语法错误栈信息。

方法二：在测试用例中直接使用try-catch + fail() #

如果只是单个测试用例需要处理，也可以直接在测试代码里用try-catch捕获解析错误，并用Jest的fail()函数主动标记测试失败：

test('API返回合法JSON且包含error字段', () => {
  let apiResponse: object;
  
  try {
    apiResponse = JSON.parse(body);
  } catch (e) {
    // 自定义失败提示，让结果更易读
    fail(`无法解析响应内容为JSON: ${(e as Error).message}`);
    // 返回避免后续代码执行
    return;
  }
  
  expect(apiResponse).toHaveProperty('error');
});

这种方式的好处是可以自定义失败信息，让你一眼就知道是解析环节出了问题，而不是断言属性时出错。

两种方法都能帮你实现“测试失败而非抛出错误”的需求，你可以根据自己的测试场景选择——如果多个测试都需要校验JSON合法性，推荐用第一种封装函数的方式；如果只是单个测试用例，第二种更直接。

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