mm_expand v1.8.0

mm_expand

这是超级美眉原型函数拓展模块，更有利于对string、array、object的操作，避免出错，简化业务逻辑。

安装

npm install mm_expand

基础函数

info(obj)

• 描述：获取函数或对象的详细信息
• 参数：
  • obj: 要查看的函数或对象
• 返回值：返回对象的详细字符串表示

sleep(milliSeconds, obj, key)

• 描述：延迟执行（休眠）函数
• 参数：
  • milliSeconds: 休眠的毫秒数
  • obj: 判断对象或函数（可选）
  • key: 判断的对象属性（可选）
• 示例：

// 简单休眠
sleep(2000);

// 带条件的休眠
var obj = {ok: false};
sleep(2000, obj, 'ok');

as(obj, query, all)

• 描述：判断对象是否相似
• 参数：
  • obj: 被判断对象
  • query: 用作判断的对象
  • all: 是否要求完全相同
• 返回值：相似返回true，否则返回false

speed(func, times)

• 描述：测试函数执行速度
• 参数：
  • func: 要测试的函数
  • times: 测试次数，默认1000000次

对象操作

push(objA, objB, bl)

• 描述：添加对象属性
• 参数：
  • objA: 被添加的对象
  • objB: 用作添加的对象
  • bl: 是否补充没有的对象
• 返回值：合并后的新对象

clear(obj)

• 描述：清空对象值
• 参数：
  • obj: 要清空的对象
• 返回值：返回清空后的对象

copy(obj, has)

• 描述：拷贝对象
• 参数：
  • obj: 被拷贝的对象
  • has: 是否只拷贝非空值
• 返回值：新对象

keys(obj, file)

• 描述：查看对象所有属性
• 参数：
  • obj: 要查看的对象
  • file: 保存结果的文件路径（可选）

数据转换

toJson(obj, format)

• 描述：将对象转为JSON字符串
• 参数：
  • obj: 要转换的对象
  • format: 是否格式化输出
• 返回值：JSON格式字符串

toXml(obj, format, mode)

• 描述：将对象转为XML字符串
• 参数：
  • obj: 要转换的对象
  • format: 是否格式化输出
  • mode: 是否使用属性格式
• 返回值：XML格式字符串

toUrl(obj, url)

• 描述：将对象转为URL参数字符串
• 参数：
  • obj: 要转换的对象
  • url: 基础URL地址（可选）
• 返回值：URL参数格式字符串

文件操作

File 类

File.prototype.getAll(dir, keyword, keyword_dir)

• 描述：搜索目录下所有文件
• 参数：
  • dir: 目录地址
  • keyword: 文件搜索关键词
  • keyword_dir: 目录搜索关键词
• 返回值：文件路径数组

File.prototype.get(dir, keyword)

• 描述：获取当前目录下所有文件
• 参数：
  • dir: 目录地址
  • keyword: 搜索关键词
• 返回值：文件路径数组

File.prototype.load(file, encode)

• 描述：加载文件内容
• 参数：
  • file: 文件路径
  • encode: 编码方式
• 返回值：文件内容字符串

File.prototype.save(file, data, encode)

• 描述：保存文件
• 参数：
  • file: 文件路径
  • data: 要保存的数据
  • encode: 编码方式
• 返回值：保存成功返回true，否则返回false

File.prototype.copy(sourcePath, targetPath)

• 描述：复制文件
• 参数：
  • sourcePath: 源文件路径
  • targetPath: 目标路径

File.prototype.del(file)

• 描述：删除文件
• 参数：
  • file: 要删除的文件路径

代码执行

run_code(code, cm, em, qm, rm)

• 描述：执行动态代码
• 参数：
  • code: 要执行的代码字符串
  • cm: 上下文参数
  • em: 额外参数
  • qm: 查询参数
  • rm: 结果参数
• 返回值：执行结果

注意事项

1. 所有文件路径操作都支持跨平台，内部会自动处理路径分隔符。
2. 文件操作相关函数建议增加错误处理。
3. 在处理大量数据时，建议使用异步方式。

许可证

ISC License

作者

qww