eslint-plugin-better-codes 1.2.11 → 1.4.11

package/README.md

@@ -46,7 +46,7 @@ module.exports = {
 禁止提交注释掉的代码：
 
 - 对于单行注释：累计行数大于等于minLines时报错。对于第一个字符为中文、大写英文字母、数字，不进行校验。如果最后面包含ignore-eslint，不进行校验（最多可以忽略minLines - 1次）
-- 对于多行注释：累计行数大于等于minLines时报错，空格行、只包含\*的行、空行不计数。如果内容包含@param、@returns(函数注释)，@D(d)escription（文件头注释），@C(c)omment（块状功能注释）不进行校验
+- 对于多行注释：单块累计行数或者累计块数大于等于minLines时报错，空格行、只包含\*的行、空行不计数。如果内容包含@param、@returns(函数注释)，@D(d)escription（文件头注释），@C(c)omment（块状功能注释）不进行校验，注释的内容如果以中文、数字、大写英文字母开头，不进行校验
 
 ### function-with-try-catch
 
@@ -79,6 +79,7 @@ module.exports = {
 
 强制使用可选链操作符（`?.`）来约束长表达式的点访问
 
+针对赋值表达式 = 左半部分的表达式不会进行校验，将来进行针对性处理
 ## 许可证
 
 MIT

package/libs/long-expression-with-optional-chain-code.js

@@ -19,6 +19,21 @@ module.exports = {
     return {
       MemberExpression(node) {
         try {
+          // 如果当前成员表达式出现在赋值语句 `=` 的左侧，则跳过校验
+          // 向上遍历祖先节点，若遇到使当前节点位于 AssignmentExpression.left 的 '=' 赋值，则直接返回
+          let anc = node;
+          while (anc && anc.parent) {
+            const p = anc.parent;
+            if (
+              p.type === "AssignmentExpression" &&
+              p.operator === "=" &&
+              p.left === anc
+            ) {
+              return;
+            }
+            anc = p;
+          }
+
           // 只在最外层的 member 表达式上检查一次，避免重复报告
           const parent = node.parent;
           if (

package/libs/no-commented-code.js

@@ -8,6 +8,14 @@ function isFunctionComment(comment, isBlock = false) {
   try {
     // 去除前后空格
     comment = comment.trim();
+    if (isBlock) {
+      // 块注释，前去除前面的例如* 换行 空格等无效代码
+      comment = comment
+        .trim()
+        .split("")
+        .filter(s => !!s && !["*", "\r", "\n"].includes(s) && !isEmptyStr(s))
+        .join("");
+    }
     // 取第一个字符
     const firstStr = comment[0];
     // 判断第一个字符是否为中文
@@ -16,12 +24,7 @@ function isFunctionComment(comment, isBlock = false) {
     const isCapitalEnglish = /^[A-Z]+$/.test(firstStr);
     // 判断第一个字符是否为数字
     const isNum = /^[0-9]+$/.test(firstStr);
-    if (
-      isChinese ||
-      isCapitalEnglish ||
-      isFuncComment(comment, isBlock) ||
-      isNum
-    ) {
+    if (isChinese || isCapitalEnglish || isFuncComment(comment) || isNum) {
       return true;
     }
   } catch (error) {
@@ -58,6 +61,19 @@ function isFuncComment(comment) {
   }
 }
 
+/**
+ * 判断是否为空值字符串，例如' ', '   ', '       ', '             '
+ * @param {String} str - 要判断的字符串
+ * @returns {Boolean} 是否为空值字符串
+ */
+function isEmptyStr(str) {
+  try {
+    return !str || str.trim().length === 0;
+  } catch (error) {
+    console.error(error);
+  }
+}
+
 module.exports = {
   meta: {
     type: "problem",

package/package.json

@@ -1,15 +1,15 @@
-{
-  "name": "eslint-plugin-better-codes",
-  "version": "1.2.11",
-  "main": "index.js",
-  "scripts": {
-    "test": "npx eslint ./test.js"
-  },
-  "keywords": [
-    "eslint",
-    "eslint-plugin"
-  ],
-  "author": "",
-  "license": "MIT",
-  "description": "eslint代码规范校验自定义插件合集,提升代码质量"
+{
+  "name": "eslint-plugin-better-codes",
+  "version": "1.4.11",
+  "main": "index.js",
+  "scripts": {
+    "test": "npx eslint ./test.js"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "description": "eslint代码规范校验自定义插件合集,提升代码质量"
 }