searchProps

English | 中文

这是一个用于搜索JavaScript对象属性的强大工具。在调试过程中，我们经常需要查找对象中的特定属性或值，searchProps工具允许您快速搜索对象中的所有信息，包括可见属性、不可见属性和Symbol属性。

安装

npm install search-props -g

使用方法

命令行使用

1. 在终端执行以下命令

searchProps

2. 将代码（Ctrl + V）粘贴到你需要的地方:

• 如开发者工具的控制台
• 如调试控制台
• 第三方库或者破解目标第三方应用程序中

API 说明

searchProps

/**
 * 对象搜索工具，支持按值、键、类型和全部四种方式搜索对象
 * @param {Object|Array} target - 要搜索的目标对象或数组
 * @param {string} searchType - 搜索类型："value"、"key"、"type" 或 "all"
 * @param {*|RegExp|Function} searchValue - 搜索值，可以是普通值、正则表达式或构造函数
 * @param {Object} [options] - 搜索选项
 * @param {Function} [options.filter] - 自定义过滤函数
 * @param {number} [options.maxDepth=0] - 最大搜索深度，<=0表示不限制深度
 * @param {number} [options.maxResults=10000] - 最大结果数量限制
 * @returns {Array} - 包含匹配结果的数组
 */
function searchProps(target, searchType, searchValue, options = {});

参数说明

• target: 要搜索的目标对象或数组
• searchType: 搜索类型
  • 'key': 按属性名搜索
  • 'value': 按属性值搜索
  • 'type': 按属性类型搜索
  • 'all': 同时搜索键、值和类型（默认）
• searchValue: 搜索值
  • 可以是普通值（字符串、数字等）
  • 可以是正则表达式（用于模式匹配）
  • 可以是对象
  • 当searchType为'type'时，可以是类型字符串（如'string', 'number', 'object', 'function', 'array', 'date', 'regexp'）或构造函数
• options: 可选配置
  • filter: 自定义过滤函数，接收(obj, key)两个参数，返回布尔值
  • maxDepth: 最大搜索深度，<=0表示不限制深度，>0限制递归搜索深度

返回值

返回一个包含匹配结果的数组，每个结果对象包含以下属性：

• paths: 属性的完整路径
• value: 属性值
• type: 属性值的类型

示例

按属性名搜索

const obj = { name: 'John', age: 30, info: { email: '[email protected]' } };
const results = searchProps(obj, 'key', 'name');
// 结果: [{ path: 'name', key: 'name', value: 'John', type: 'string' }]

使用正则表达式搜索

const obj = { name: 'John', username: 'john_doe', email: '[email protected]' };
const results = searchProps(obj, 'key', /name/);
// 结果: 匹配所有包含'name'的键

按类型搜索

const obj = { name: 'John', age: 30, active: true, tags: ['user', 'admin'] };
const results = searchProps(obj, 'type', Array);
// 结果: 匹配所有数组类型的属性

搜索Symbol属性

const sym = Symbol('testSymbol');
const obj = { [sym]: 'Symbol value' };
const results = searchProps(obj, 'key', sym.toString());
// 结果: 匹配Symbol属性

使用自定义过滤器

const obj = { name: 'John', _private: 'secret', age: 30 };
const results = searchProps(obj, 'all', null, {
  filter: (obj, key) => !String(key).startsWith('_')
});
// 结果: 排除所有以下划线开头的属性

特性

• 支持搜索深层嵌套对象
• 支持搜索数组元素
• 支持搜索不可枚举属性
• 支持搜索Symbol属性
• 自动处理循环引用
• 支持使用正则表达式进行模式匹配
• 支持对象深度比较
• 提供详细的属性路径信息