mm_https 1.6.4 → 1.6.6

package/README.md

@@ -13,7 +13,9 @@ npm install mm_https
 ### 初始化
 
 ```javascript
-const Http = require('mm_https');
+const {
+    Http
+} = require('mm_https');
 
 // 基本初始化
 const http = new Http();
@@ -40,6 +42,10 @@ const httpWithConfig = new Http({
 ### GET请求
 
 ```javascript
+const {
+    Http
+} = new Http();
+
 const http = new Http();
 
 // 基本GET请求
@@ -67,6 +73,10 @@ async function getWithCookie() {
 ### POST请求
 
 ```javascript
+const {
+    Http
+} = new Http();
+
 const http = new Http();
 
 // JSON格式POST请求
@@ -101,6 +111,10 @@ async function postWithHeadersAndCookie() {
 ### 文件下载
 
 ```javascript
+const {
+    Http
+} = new Http();
+
 const http = new Http();
 
 // 基本文件下载
@@ -134,11 +148,21 @@ async function downloadWithHeaders() {
 ### Cookie管理
 
 ```javascript
+const {
+    Http
+} = new Http();
+
 const http = new Http();
 
 // 设置Cookie
 http.setCookie('session=abc123; user=john');
 
+// 或者通过对象设置多个Cookie
+http.setCookie({
+    'session': 'abc123',
+    'user': 'john'
+});
+
 // 获取当前所有Cookie
 const cookieString = http.getCookie();
 $.log.debug('当前Cookie:', cookieString);

package/eslint.config.js

@@ -0,0 +1,68 @@
+const jsdoc = require('eslint-plugin-jsdoc');
+
+module.exports = [
+  {
+    files: ['lib/**/*.js'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: 'script'
+    },
+    plugins: {
+      jsdoc: jsdoc
+    },
+    rules: {
+      // JSDoc相关规则 - 设置为error级别强制要求
+      'jsdoc/require-jsdoc': ['error', {
+        require: {
+          FunctionDeclaration: true,
+          MethodDefinition: true,
+          ClassDeclaration: true,
+          ArrowFunctionExpression: true
+        }
+      }],
+      'jsdoc/check-param-names': 'off',
+      'jsdoc/check-tag-names': 'off',
+      'jsdoc/check-types': 'off',
+      'jsdoc/require-param': 'off',
+      'jsdoc/require-param-description': 'off',
+      'jsdoc/require-returns': 'off',
+      'jsdoc/require-returns-description': 'off',
+      
+      // 基础语法规则
+      'no-unused-vars': ['error', { args: 'none', vars: 'all' }],
+      'no-console': 'warn',
+      
+      // 代码风格规则
+      'indent': ['error', 2],
+      'quotes': ['error', 'single'],
+      'semi': ['error', 'always'],
+      'comma-dangle': ['error', 'never'],
+      'no-trailing-spaces': 'error',
+      'eol-last': 'error',
+      'max-len': ['error', { code: 100 }],
+      'max-lines-per-function': ['error', { max: 40 }],
+      'complexity': ['error', 12],
+      'max-depth': ['error', 4],
+      'max-params': ['error', 4],
+      
+      // 命名规则
+      'id-length': ['error', {
+        min: 1,
+        max: 20,
+        properties: 'always'
+      }]
+    }
+  },
+  {
+    files: ['test/**/*.js'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: 'script'
+    },
+    rules: {
+      // 测试文件中允许使用console
+      'no-console': 'off',
+      'no-unused-vars': 'off'
+    }
+  }
+];

package/index.js

@@ -56,9 +56,21 @@ class Http {
 			var headers = this.changeHeaders(config.headers);
 			Object.assign(this._headers, headers);
 		}
+
+		this._logger = $.log || console;
 	}
 }
 
+/**
+ * 日志记录
+ * @param {string} level - 日志级别
+ * @param {string} message - 日志消息
+ * @param {...*} args - 日志参数
+ */
+Http.prototype.log = function (level, message, ...args) {
+	this._logger[level](`[${this.constructor.name}] ${message}`, ...args);
+}
+
 /**
  * 设置Cookie
  * @param {Object|String} cookies - Cookie字符串
@@ -351,7 +363,7 @@ Http.prototype.request = function (options) {
 		});
 
 		req.on("error", function (err) {
-			$.log.debug("错误", err);
+			self.log("debug", "错误", err);
 			resolve({
 				status: 0,
 				message: err.message
@@ -437,7 +449,7 @@ Http.prototype.download = async function (url, filename, auto, headers, cookie)
 				filePath = null;
 			}
 		} else {
-			$.log.debug('保存文件名(filename)不能为!');
+			this.log("debug", '保存文件名(filename)不能为!');
 		}
 	}
 	return filePath;
@@ -450,11 +462,9 @@ Http.prototype.clear = function () {
 	this._cookies = {};
 };
 
-if (global.$) {
-	$.Http = Http;
-}
-
 /**
  * 导出构造函数
  */
-module.exports = Http;
+module.exports = {
+	Http
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mm_https",
-	"version": "1.6.4",
+	"version": "1.6.6",
 	"description": "超级美眉HTTP请求模块 - 支持自动Cookie管理、代理设置、文件下载等功能",
 	"main": "index.js",
 	"scripts": {
@@ -34,7 +34,7 @@
 	},
 	"dependencies": {
 		"https-proxy-agent": "^7.0.6",
-		"iconv-lite": "^0.7.0",
-		"mm_expand": "^1.9.7"
+		"iconv-lite": "^0.7.1",
+		"mm_expand": "^2.0.0"
 	}
 }

package/test.js

@@ -3,8 +3,9 @@
  * 用于npm发布前的功能验证
  */
 
-const Http = require('./index.js');
-const fs = require('fs');
+const {
+	Http
+} = require('./index.js');
 
 /**
  * 基础HTTP请求测试
@@ -97,7 +98,8 @@ async function testErrorHandling() {
 			// 设置较短的超时时间，避免长时间等待
 			const timeoutHttp = new Http();
 			// 使用不存在的域名进行测试
-			await timeoutHttp.get('http://nonexistent-domain-12345.test');
+			const res = await timeoutHttp.get('http://nonexistent-domain-12345.test');
+			console.log('GET响应状态码:', res.status, '响应消息:', res.message, '响应内容:', res.body);
 			console.log('⚠️  不存在的域名测试 - 请求可能被重定向或超时');
 		} catch (err) {
 			console.log('不存在的域名处理正确:', err.message);

package/npm-publish-checklist.md

@@ -1,99 +0,0 @@
-# mm_https模块 npm发布检查清单
-
-## ✅ 已完成的项目
-
-### 1. 代码重构和规范
-- [x] 类名和方法名使用小驼峰命名法
-- [x] 私有成员使用下划线前缀
-- [x] 变量名使用小写蛇形命名法
-- [x] 完整的JSDoc注释
-- [x] 符合ES6类和原型方法范式
-
-### 2. 测试文件优化
-- [x] 创建适合npm发布的测试文件
-- [x] 包含基础功能测试
-- [x] 包含高级功能测试
-- [x] 包含错误处理测试
-- [x] 所有测试通过
-
-### 3. 配置文件优化
-- [x] 更新package.json描述和关键词
-- [x] 添加Node.js版本要求
-- [x] 优化依赖管理
-
-### 4. 功能验证
-- [x] 语法检查通过
-- [x] 依赖关系正常
-- [x] 模块功能完整
-
-## 📋 npm发布前检查
-
-### 版本管理
-- [ ] 确认当前版本号：1.6.4
-- [ ] 是否需要更新版本号
-- [ ] 更新CHANGELOG.md（如有）
-
-### 文档检查
-- [ ] README.md内容完整且准确
-- [ ] 示例代码正确
-- [ ] 安装说明清晰
-
-### 发布准备
-- [ ] 登录npm账号：`npm login`
-- [ ] 检查包名可用性：`npm search mm_https`
-- [ ] 执行发布命令：`npm publish`
-
-## 🚀 发布命令
-
-```bash
-# 登录npm（如果未登录）
-npm login
-
-# 检查包名是否可用
-npm search mm_https
-
-# 发布到npm
-npm publish
-
-# 或者发布为公开包（如果需要）
-npm publish --access public
-```
-
-## 📦 安装使用
-
-发布后，用户可以通过以下方式安装：
-
-```bash
-npm install mm_https
-```
-
-使用示例：
-```javascript
-const { Http } = require('mm_https');
-
-async function example() {
-    const http = new Http();
-    const res = await http.get('https://httpbin.org/get');
-    console.log(res.body);
-}
-```
-
-## 🔧 开发命令
-
-```bash
-# 运行测试
-npm test
-
-# 开发模式
-npm run dev
-
-# 安装依赖
-npm install
-```
-
-## 📞 支持信息
-
-- 作者：邱文武
-- 许可证：ISC
-- 问题反馈：https://gitee.com/qiuwenwu91/mm_https/issues
-- 主页：https://gitee.com/qiuwenwu91/mm_https#readme