
本文介绍一种递归式搜索方案,可对任意深度的嵌套对象、数组及原始值进行不区分大小写的子字符串匹配,并精准返回包含匹配项的顶层对象。
在实际开发中,前端常需实现“全局搜索”功能——用户输入关键词(如 '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'] })。










