如何在嵌套对象与数组中实现全字段模糊搜索-js教程

本文介绍一种递归式搜索方案，可对任意深度的嵌套对象、数组及原始值进行不区分大小写的子字符串匹配，并精准返回包含匹配项的顶层对象。

在实际开发中，前端常需实现“全局搜索”功能——用户输入关键词（如 ‘Ident’ 或 ‘Clos’），系统应遍历整个数据结构（包括对象的嵌套属性、数组元素、甚至深层嵌套对象），只要任意位置的字符串值包含该关键词，就将其所属的顶层对象纳入结果集。

原始 filterByValue 函数仅处理了对象的一级属性，无法穿透 platformList（数组）或 radar_metadata（嵌套对象）。要支持深层搜索，核心思路是：对每个属性值做类型判断，并递归处理复合类型（对象/数组），仅对原始值执行字符串匹配。

以下是优化后的完整实现：

const filterByValue = (array, string) => {
  // 确保输入为数组，避免非数组入参导致错误
  if (!Array.isArray(array)) return [];

  const searchTerm = string?.toString().toLowerCase() || '';

  return array.filter((obj) => {
    if (obj === null || typeof obj !== 'object') return false;

    return Object.keys(obj).some((key) => {
      const value = obj[key];

      if (Array.isArray(value)) {
        // 递归搜索数组：任一元素匹配即满足条件
        return filterByValue(value, string).length > 0;
      } else if (value !== null && typeof value === 'object') {
        // 递归搜索嵌套对象：任一子属性匹配即满足条件
        return filterByValue([value], string).length > 0;
      } else {
        // 原始值（string/number/boolean等）→ 转字符串后模糊匹配
        return value?.toString().toLowerCase().includes(searchTerm);
      }
    });
  });
};

✅ 关键特性说明：