嵌套数组如何实现模糊查询

本文深入解析了一种高效可靠的递归模糊搜索方案，专为解决前端开发中对任意深度嵌套对象数组（含多层对象、数组及原始值）的全局关键词匹配难题——无论用户输入“Ident”“Clos”还是“ver”，系统都能穿透所有层级，精准定位包含子字符串的任意字段，并完整返回其所属的顶层对象；代码兼顾健壮性（自动处理null、undefined、非对象输入）、性能意识（统一小写预处理、浅拷贝不污染源数据）与扩展潜力（支持后续添加字段白名单、正则匹配等），是构建动态搜索功能的即用型利器。

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

在实际开发中，前端常需实现“全局搜索”功能——用户输入关键词（如 '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);
      }
    });
  });
};

✅ 关键特性说明：

• ✅ 安全兜底：检查 null、非对象类型及 undefined 输入，防止运行时错误；
• ✅ 统一转小写：searchTerm 提前标准化，避免重复调用 toLowerCase()；
• ✅ 精准返回顶层对象：无论匹配发生在 vertical、platformList[0] 还是 radar_metadata.state，都返回整个外层对象；
• ✅ 支持多层嵌套：可处理 radar_metadata.user.profile.name 等任意深度路径。

? 验证示例：

const input = [
  {
    vertical: "Partner",
    platformList: ["Access"],
    radar_metadata: { state: "Verify" }
  },
  {
    vertical: "Integration",
    platformList: ["Identity"],
    radar_metadata: { state: "Closed" }
  }
];

console.log(filterByValue(input, 'Ident')); // → 第二个对象（匹配 "Identity"）
console.log(filterByValue(input, 'Clos'));  // → 第二个对象（匹配 "Closed"）
console.log(filterByValue(input, 'ver'));   // → 两个对象均命中（"Partner" + "Verify"）

⚠️ 注意事项：

• 该函数为浅拷贝过滤，不修改原始数据；
• 若数据结构极深或极大（如 >10 层嵌套 / >10k 条目），建议结合防抖、分页或 Web Worker 优化性能；
• 如需精确匹配、正则支持或字段白名单控制，可在递归逻辑中扩展参数（如 options = { fields: ['vertical', 'radar_metadata.state'] }）。

通过这一递归设计，你获得了一个健壮、可复用、开箱即用的嵌套数据搜索工具，完美支撑复杂业务场景下的动态检索需求。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~