mm_expand 1.9.7 → 1.9.8

package/README.md

@@ -15,6 +15,7 @@ mm_expand 是一个功能丰富的 JavaScript 工具库，为原生类型（Stri
 
 - **原生类型扩展**：为 String、Array、Number、Date 等原生类型提供丰富的原型方法
 - **对象操作增强**：提供深度拷贝、对象合并、属性遍历等实用功能
+- **对象验证系统**：提供完整的对象属性验证功能，支持类型、必填、格式等验证规则
 - **文件系统简化**：直观的文件读写、复制、删除等操作方法
 - **灵活事件系统**：支持命名空间、优先级、中间件、节流防抖等高级特性
 - **数据转换工具**：JSON、XML、URL 参数等格式转换功能
@@ -60,6 +61,19 @@ const formattedDate = new Date().toStr('yyyy-MM-dd hh:mm:ss'); // 格式化日
 // 对象操作
 const copiedObj = $.copy({ a: 1, b: { c: 2 } }); // 深度拷贝对象
 
+// 对象验证
+const user = { name: '张三', age: 25, email: 'zhangsan@example.com' };
+// 批量验证
+user.check({
+  name: { required: true, type: 'string', min: 2, max: 20 },
+  age: { required: true, type: 'number', min: 18, max: 100 },
+  email: { required: true, type: 'email' }
+});
+// 链式验证
+user.checkVal('name', { required: true, type: 'string', min: 2, max: 20 })
+    .checkVal('age', { required: true, type: 'number', min: 18, max: 100 })
+    .checkVal('email', { required: true, type: 'email' });
+
 // 事件系统使用
 // 注册事件
 $.eventer.on('user:login', (userData) => {
@@ -214,6 +228,37 @@ await $.sleep(2000, obj, 'ok');
   - obj: 要查看的对象
   - file: 保存结果的文件路径（可选）
 
+### 对象验证
+
+#### Object.prototype.check(rules)
+- 描述：检查对象是否符合指定规则
+- 参数：
+  - rules: 验证规则对象
+- 返回值：验证通过返回原始对象，失败抛出TypeError
+- 示例：
+```javascript
+const user = { name: '张三', age: 25, email: 'zhangsan@example.com' };
+user.check({
+  name: { required: true, type: 'string', min: 2, max: 20 },
+  age: { required: true, type: 'number', min: 18, max: 100 },
+  email: { required: true, type: 'email' }
+});
+```
+
+#### Object.prototype.checkVal(key, rule)
+- 描述：检查对象属性值是否符合指定规则
+- 参数：
+  - key: 属性名
+  - rule: 验证规则
+- 返回值：验证通过返回原始对象，失败抛出TypeError
+- 示例：
+```javascript
+const user = { name: '张三', age: 25, email: 'zhangsan@example.com' };
+user.checkVal('name', { required: true, type: 'string', min: 2, max: 20 })
+    .checkVal('age', { required: true, type: 'number', min: 18, max: 100 })
+    .checkVal('email', { required: true, type: 'email' });
+```
+
 ### 数据转换
 
 #### $.toJson(obj, format)

package/README_EN.md

@@ -15,6 +15,7 @@ This library extends JavaScript native object prototypes with comprehensive data
 
 - **Native Type Extension**: Rich prototype methods for native types like String, Array, Number, Date, etc.
 - **Enhanced Object Operations**: Deep copy, object merging, property traversal, and other practical functions
+- **Object Validation System**: Complete object property validation with support for type, required, format, and other validation rules
 - **Simplified File System**: Intuitive file read/write, copy, delete, and other operation methods
 - **Flexible Event System**: Supports advanced features like namespaces, priorities, middleware, throttling, and debouncing
 - **Data Conversion Tools**: JSON, XML, URL parameters, and other format conversion functions
@@ -86,6 +87,19 @@ const formattedDate = new Date().toStr('yyyy-MM-dd hh:mm:ss'); // Format date
 // Object operations
 const copiedObj = $.copy({ a: 1, b: { c: 2 } }); // Deep copy object
 
+// Object validation
+const user = { name: 'John', age: 25, email: 'john@example.com' };
+// Batch validation
+user.check({
+  name: { required: true, type: 'string', min: 2, max: 20 },
+  age: { required: true, type: 'number', min: 18, max: 100 },
+  email: { required: true, type: 'email' }
+});
+// Chain validation
+user.checkVal('name', { required: true, type: 'string', min: 2, max: 20 })
+    .checkVal('age', { required: true, type: 'number', min: 18, max: 100 })
+    .checkVal('email', { required: true, type: 'email' });
+
 // Event system usage
 // Register event
 $.eventer.on('user:login', (userData) => {
@@ -240,6 +254,37 @@ await $.sleep(2000, obj, 'ok');
   - obj: Object to inspect
   - file: File path to save results (optional)
 
+### Object Validation
+
+#### Object.prototype.check(rules)
+- Description: Check if object conforms to specified rules
+- Parameters:
+  - rules: Validation rules object
+- Returns: Returns original object if validation passes, throws TypeError if fails
+- Example:
+```javascript
+const user = { name: 'John', age: 25, email: 'john@example.com' };
+user.check({
+  name: { required: true, type: 'string', min: 2, max: 20 },
+  age: { required: true, type: 'number', min: 18, max: 100 },
+  email: { required: true, type: 'email' }
+});
+```
+
+#### Object.prototype.checkVal(key, rule)
+- Description: Check if object property value conforms to specified rules
+- Parameters:
+  - key: Property name
+  - rule: Validation rule
+- Returns: Returns original object if validation passes, throws TypeError if fails
+- Example:
+```javascript
+const user = { name: 'John', age: 25, email: 'john@example.com' };
+user.checkVal('name', { required: true, type: 'string', min: 2, max: 20 })
+    .checkVal('age', { required: true, type: 'number', min: 18, max: 100 })
+    .checkVal('email', { required: true, type: 'email' });
+```
+
 ### Data Conversion
 
 #### $.toJson(obj, format)

package/index.js

@@ -1,6 +1,6 @@
 /**
  * @fileOverview JavaScript拓展函数
- * @author <a href="http://qww.elins.cn">邱文武</a>
+ * @author <a href="http://qww.elins.cn">qww</a>
  * @version 1.2
  */
 
@@ -16,30 +16,29 @@ require('./lib/array.js');
 require('./lib/date.js');
 
 var { File, Dir } = require('./lib/file.js');
-var { Log } = require('./lib/log.js');
-var { Eventer } = require('./lib/eventer.js');
+var { Logger } = require('./lib/logger.js');
+var { Eventer, eventer } = require('./lib/eventer.js');
 var { Lang } = require('./lib/lang.js');
 var { Event } = require('./lib/event.js');
 var { Base } = require('./lib/base.js');
 var { Timer } = require('./lib/timer.js');
+var { Validator, validator } = require('./lib/validator.js');
 
 
 if (global.$ && !$.is_init) {
 	Object.assign($, require('./lib/object.js'), {
-		// 基础类
-		Base,
-		// 事件类
-		Event,
+		// 验证器类
+		validator,
+		// 事件驱动类
+		eventer,
+		// 日志类
+		logger: new Logger(),
 		// 文件类
 		file: new File(),
 		// 目录类
 		dir: new Dir(),
-		// 事件驱动类
-		eventer: new Eventer(),
 		// 定时器类
 		timer: new Timer(),
-		// 日志类
-		log: new Log(),
 		// 语言包类
 		lang: new Lang({
 			zh_cn: {
@@ -48,16 +47,38 @@ if (global.$ && !$.is_init) {
 			en: {
 				name: "MM"
 			}
-		})
+		}),
+		// 基础类
+		Base,
+		// 事件类
+		Event
 	});
 	$.is_init = true;
 }
 
 module.exports = {
+	// 全局对象
+	$: global.$,
+	// 验证器类
+	Validator,
+	// 事件类
 	Event,
+	// 事件驱动类
 	Eventer,
+	// 定时器类
+	Timer,
+	// 日志类
+	Logger,
+	// 语言包类
 	Lang,
+	// 基础类
 	Base,
+	// 文件类
 	File,
-	Dir
+	// 目录类
+	Dir,
+	// 验证器实例
+	validator,
+	// 事件驱动实例
+	eventer
 }

package/lib/array.js

@@ -808,4 +808,6 @@ Array.prototype.insertList = function (index, list) {
     }
 }
 
-exports.Array = Array;
+module.exports = {
+	Array
+}

package/lib/base.js

@@ -48,16 +48,6 @@ class Base extends Event {
 	}
 }
 
-/**
- * 日志输出
- * @param {String} level 日志级别
- * @param {String} message 日志消息
- * @param  {...any} args 日志参数
- */
-Base.prototype.logger = function (level, message, ...args) {
-	this._logger[level](`[${this.constructor.name}] ${message}`, ...args);
-}
-
 /**
  * 初始化监听
  */
@@ -181,7 +171,7 @@ Base.prototype.end = async function () {
  */
 Base.prototype.do = async function (method, ...args) {
 	if (!this[method]) {
-		throw new Error(`[${this.constructor.name}] 方法${method}不存在`);
+		throw new Error(`方法${method}不存在`);
 	}
 
 	let ctx = {
@@ -229,7 +219,7 @@ Base.prototype.do = async function (method, ...args) {
 	// 5. 错误处理（异步执行，不阻塞）
 	if (ctx.error) {
 		await this.emitAsync(method + ':error', ctx);
-		this.logger('error', `[${this.constructor.name}] 执行方法${method}出错：`, ctx.error);
+		this.log('error', `执行方法${method}出错：`, ctx.error);
 	}
 
 	// 6. 后置处理（顺序执行）
@@ -247,7 +237,7 @@ Base.prototype.do = async function (method, ...args) {
 Base.prototype.doEasy = async function (method, ...args) {
 	// 快速检查方法是否存在
 	if (!this[method]) {
-		throw new Error(`[${this.constructor.name}] 方法${method}不存在`);
+		throw new Error(`方法${method}不存在`);
 	}
 
 	try {
@@ -255,7 +245,7 @@ Base.prototype.doEasy = async function (method, ...args) {
 		return await this[method](...args);
 	} catch (error) {
 		// 简单错误处理
-		this.logger('error', `[${this.constructor.name}] 快速执行方法${method}出错：`, error);
+		this.log('error', `快速执行方法${method}出错：`, error);
 		throw error;
 	}
 }
@@ -335,7 +325,7 @@ Base.prototype.cmd = async function (command, ...args) {
 				try {
 					return await obj(...args);
 				} catch (error) {
-					this.logger('error', `执行方法${command}出错：`, error);
+					this.log('error', `执行方法${command}出错：`, error);
 					return undefined;
 				}
 			} else if (Array.isArray(obj)) {
@@ -442,5 +432,7 @@ function createClass(config, cs_old = {}) {
 	return cs;
 };
 
-exports.Base = Base;
-exports.createClass = createClass;
+module.exports = {
+	Base,
+	createClass
+}

package/lib/event.js

@@ -17,7 +17,7 @@ class Event extends EventEmitter {
  * @param {String} message 日志消息
  * @param  {...any} args 日志参数
  */
-Event.prototype.logger = function (level, message, ...args) {
+Event.prototype.log = function (level, message, ...args) {
 	this._logger[level](`[${this.constructor.name}] ${message}`, ...args);
 }
 
@@ -36,7 +36,7 @@ Event.prototype.emitWait = async function (event, ...args) {
             try {
                 await listener(...args);
             } catch (err) {
-                this.logger('error', 'Error in async event listener:', err);
+                this.log('error', 'Error in async event listener:', err);
             }
         }
     }
@@ -62,12 +62,12 @@ Event.prototype.emitAsync = async function (event, ...args) {
             Promise.resolve(listener(...args))
                 .catch(error => {
                     // 错误处理 - 记录但不抛出
-                    this.logger('error', `Async listener error for event ${event}:`, error);
+                    this.log('error', `Async listener error for event ${event}:`, error);
                     this.emit('async:error', error, event, args);
                 });
         } catch (syncError) {
             // 同步错误处理
-            this.logger('error', `Sync listener error for event ${event}:`, syncError);
+            this.log('error', `Sync listener error for event ${event}:`, syncError);
             this.emit('sync:error', syncError, event, args);
         }
     });
@@ -142,7 +142,7 @@ Event.prototype.emitWaterfall = async function (event, value, ...args) {
         try {
             val = await listener(val, ...args);
         } catch (error) {
-            this.logger('error', 'Waterfall execution failed:', error);
+            this.log('error', 'Waterfall execution failed:', error);
             throw error;
         }
     }