
本文介绍一种递归式搜索方案,可对任意深度的嵌套对象、数组及原始值进行不区分大小写的子字符串匹配,并精准返回包含匹配项的顶层对象。
在实际开发中,前端常需实现“全局搜索”功能——用户输入关键词(如 ‘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’] })。
通过这一递归设计,你获得了一个健壮、可复用、开箱即用的嵌套数据搜索工具,完美支撑复杂业务场景下的动态检索需求。