本文介绍一种灵活、可复用的 javascript 函数，支持传入字段名数组，在对象数组中仅针对指定属性执行不区分大小写的子字符串匹配，避免硬编码字段，提升搜索逻辑的通用性与可维护性。
本文介绍一种灵活、可复用的 javascript 函数，支持传入字段名数组，在对象数组中仅针对指定属性执行不区分大小写的子字符串匹配，避免硬编码字段，提升搜索逻辑的通用性与可维护性。
在实际开发中，我们常需对一组对象（如用户列表、商品数据）进行前端搜索。但并非所有字段都适合参与搜索——例如 id 字段通常为数字或 UUID，用户极少按 ID 模糊查找；而 name、description、category 等文本型字段才是合理目标。若每次新增搜索场景都重写 filter 逻辑，将导致代码重复、难以维护。
为此，我们可以设计一个高阶搜索函数 searchInData，接受三个参数：搜索关键词（searchString）、待查数据数组（searchData）和可选的字段白名单数组（fieldsForSearch）。该函数会自动遍历每个对象中指定字段的值，并执行不区分大小写的 .includes() 匹配。
以下是完整实现：
function searchInData(searchString, searchData, fieldsForSearch) {
// 若未提供搜索关键词，直接返回原数组（或空数组，依业务需求调整）
if (!searchString || !searchString.trim()) return searchData ?? [];
const keyword = searchString.trim().toLocaleLowerCase();
// 若未传入字段数组，则默认搜索对象所有自有属性的值
if (!Array.isArray(fieldsForSearch) || fieldsForSearch.length === 0) {
return (searchData ?? []).filter(item =>
Object.values(item).some(value =>
String(value).toLowerCase().includes(keyword)
)
);
}
// 否则，仅搜索 fieldsForSearch 中声明且真实存在的字段
return (searchData ?? []).filter(item =>
fieldsForSearch.some(field =>
Object.hasOwn(item, field) &&
String(item[field]).toLowerCase().includes(keyword)
)
);
}✅ 关键特性说明：
立即学习“Java免费学习笔记（深入）”；
- 使用 Object.hasOwn(item, field) 替代过时的 item.hasOwnProperty()，确保只检查对象自身属性（非原型链继承）；
- 对所有字段值统一调用 String(value) 转换，兼容 number、boolean、null、undefined 等类型（如 age: 25 → "25".includes("2") 返回 true）；
- 自动 trim() 和 toLowerCase() 处理关键词，提升用户体验与匹配鲁棒性；
- 健壮处理边界情况：空数组、null/undefined 输入、不存在的字段名均不会报错，而是安全跳过。
? 使用示例：
const src = [
{ id: 1, name: "Alice Johnson", age: 25, city: "New York" },
{ id: 2, name: "Bob Smith", age: 33, city: "San Francisco" },
{ id: 3, name: "Charlie Brown", age: 28, city: "Chicago" }
];
// ✅ 只搜 name 和 city（忽略 id、age）
console.log(searchInData("son", src, ["name", "city"]));
// → [{ id: 1, name: "Alice Johnson", ... }, { id: 2, name: "Bob Smith", ... }]
// ✅ 搜索所有字段（等价于未传 fieldsForSearch）
console.log(searchInData("25", src));
// → [{ id: 1, name: "Alice Johnson", age: 25, ... }]
// ⚠️ 指定不存在的字段，结果为空数组（安全）
console.log(searchInData("test", src, ["email", "phone"])); // → []? 进阶建议：
- 如需支持正则高级匹配（如忽略空格、全字匹配），可将 keyword 封装为 RegExp 并改用 .test()；
- 对于大数据量（>1000 条），建议配合防抖（debounce）控制触发频率；
- 若字段值含嵌套对象或数组，需扩展递归提取逻辑（本例聚焦扁平结构）。
该方案以最小侵入性解耦搜索逻辑与数据结构，一次封装，多处复用，是构建可维护前端搜索功能的理想基础。
