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

1次阅读

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

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

在实际开发中,前端常需实现“全局搜索”功能——用户输入关键词(如 ‘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’] })。

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

text=ZqhQzanResources