feat(no-async-in-computed-properties): add ignoredObjectNames option

Author: waynzh

docs/rules/no-async-in-computed-properties.md

@@ -108,7 +108,42 @@ export default {
 
 ## :wrench: Options
 
-Nothing.
+```js
+{
+  "vue/no-async-in-computed-properties": ["error", {
+    "ignoredObjectNames": []
+  }]
+}
+```
+
+- `ignoredObjectNames`: An array of object names that should be ignored when used with promise-like methods (`.then()`, `.catch()`, `.finally()`). This is useful for validation libraries like Zod that use these method names for non-promise purposes.
+
+### `"ignoredObjectNames": ["z"]`
+
+<eslint-code-block :rules="{'vue/no-async-in-computed-properties': ['error', {ignoredObjectNames: ['z']}]}">
+
+```vue
+<script setup>
+import { computed } from 'vue'
+import { z } from 'zod'
+
+/* ✓ GOOD */
+const schema1 = computed(() => {
+  return z.string().catch('default')
+})
+
+const schema2 = computed(() => {
+  return z.catch(z.string().min(2), 'fallback')
+})
+
+/* ✗ BAD */
+const fetchData = computed(() => {
+  return myFunc().then(res => res.json())
+})
+</script>
+```
+
+</eslint-code-block>
 
 ## :books: Further Reading
 

lib/rules/no-async-in-computed-properties.js

@@ -38,22 +38,60 @@ function isTimedFunction(node) {
   )
 }
 
+/**
+ * Get the root object name from a member expression chain
+ * @param {MemberExpression} memberExpr
+ * @returns {string|null}
+ */
+function getRootObjectName(memberExpr) {
+  let current = memberExpr.object
+
+  while (current) {
+    if (current.type === 'MemberExpression') {
+      current = utils.skipChainExpression(current.object)
+    } else if (current.type === 'CallExpression') {
+      const calleeExpr = utils.skipChainExpression(current.callee)
+      if (calleeExpr.type === 'MemberExpression') {
+        current = calleeExpr.object
+      } else if (calleeExpr.type === 'Identifier') {
+        return calleeExpr.name
+      } else {
+        break
+      }
+    } else if (current.type === 'Identifier') {
+      return current.name
+    } else {
+      break
+    }
+  }
+
+  return null
+}
+
 /**
  * @param {CallExpression} node
+ * @param {Set<string>} ignoredObjectNames
  */
-function isPromise(node) {
+function isPromise(node, ignoredObjectNames) {
   const callee = utils.skipChainExpression(node.callee)
   if (callee.type === 'MemberExpression') {
     const name = utils.getStaticPropertyName(callee)
-    return (
-      name &&
-      // hello.PROMISE_FUNCTION()
-      (PROMISE_FUNCTIONS.has(name) ||
-        // Promise.PROMISE_METHOD()
-        (callee.object.type === 'Identifier' &&
-          callee.object.name === 'Promise' &&
-          PROMISE_METHODS.has(name)))
-    )
+    if (!name) return false
+
+    const isPromiseMethod =
+      PROMISE_FUNCTIONS.has(name) ||
+      (callee.object.type === 'Identifier' &&
+        callee.object.name === 'Promise' &&
+        PROMISE_METHODS.has(name))
+
+    if (!isPromiseMethod) return false
+
+    const rootObjectName = getRootObjectName(callee)
+    if (rootObjectName && ignoredObjectNames.has(rootObjectName)) {
+      return false
+    }
+
+    return true
   }
   return false
 }
@@ -85,7 +123,20 @@ module.exports = {
       url: 'https://eslint.vuejs.org/rules/no-async-in-computed-properties.html'
     },
     fixable: null,
-    schema: [],
+    schema: [
+      {
+        type: 'object',
+        properties: {
+          ignoredObjectNames: {
+            type: 'array',
+            items: { type: 'string' },
+            uniqueItems: true,
+            additionalItems: false
+          }
+        },
+        additionalProperties: false
+      }
+    ],
     messages: {
       unexpectedInFunction:
         'Unexpected {{expressionName}} in computed function.',
@@ -95,6 +146,9 @@ module.exports = {
   },
   /** @param {RuleContext} context */
   create(context) {
+    const options = context.options[0] || {}
+    const ignoredObjectNames = new Set(options.ignoredObjectNames || [])
+
     /** @type {Map<ObjectExpression, ComponentComputedProperty[]>} */
     const computedPropertiesMap = new Map()
     /** @type {(FunctionExpression | ArrowFunctionExpression)[]} */
@@ -217,7 +271,7 @@ module.exports = {
         if (!scopeStack) {
           return
         }
-        if (isPromise(node)) {
+        if (isPromise(node, ignoredObjectNames)) {
           verify(
             node,
             scopeStack.body,

tests/lib/rules/no-async-in-computed-properties.js

@@ -324,6 +324,52 @@ ruleTester.run('no-async-in-computed-properties', rule, {
         sourceType: 'module',
         ecmaVersion: 2020
       }
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        export default {
+          computed: {
+            foo: function () {
+              return z.catch(
+                z.string().check(z.minLength(2)),
+                'default'
+              ).then(val => val).finally(() => {})
+            }
+          }
+        }
+      `,
+      options: [{ ignoredObjectNames: ['z'] }],
+      languageOptions
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import { computed } from 'vue'
+
+      const numberWithCatch = computed(() => z.number().catch(42))
+      </script>`,
+      options: [{ ignoredObjectNames: ['z'] }],
+      languageOptions: {
+        parser,
+        sourceType: 'module',
+        ecmaVersion: 2020
+      }
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        export default {
+          computed: {
+            foo: function () {
+              return z.a.b.c.d.e.f.method().catch(err => err).finally(() => {})
+            }
+          }
+        }
+      `,
+      options: [{ ignoredObjectNames: ['z'] }],
+      languageOptions
     }
   ],
 
@@ -1542,6 +1588,98 @@ ruleTester.run('no-async-in-computed-properties', rule, {
           endColumn: 8
         }
       ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        export default {
+          computed: {
+            foo: function () {
+              return myFunc().catch('default')
+            }
+          }
+        }
+      `,
+      languageOptions,
+      errors: [
+        {
+          message: 'Unexpected asynchronous action in "foo" computed property.',
+          line: 5,
+          column: 22,
+          endLine: 5,
+          endColumn: 47
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        export default {
+          computed: {
+            foo: function () {
+              return z.number().catch(42)
+            }
+          }
+        }
+      `,
+      languageOptions,
+      errors: [
+        {
+          message: 'Unexpected asynchronous action in "foo" computed property.',
+          line: 5,
+          column: 22,
+          endLine: 5,
+          endColumn: 42
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        export default {
+          computed: {
+            foo: function () {
+              return someLib.string().catch(42)
+            }
+          }
+        }
+      `,
+      options: [{ ignoredObjectNames: ['z'] }],
+      languageOptions,
+      errors: [
+        {
+          message: 'Unexpected asynchronous action in "foo" computed property.',
+          line: 5,
+          column: 22,
+          endLine: 5,
+          endColumn: 48
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+        <script setup>
+        import {computed} from 'vue'
+
+        const deepCall = computed(() => z.a.b.c.d().e().f().catch())
+        </script>
+      `,
+      options: [{ ignoredObjectNames: ['a'] }],
+      languageOptions: {
+        parser,
+        sourceType: 'module',
+        ecmaVersion: 2020
+      },
+      errors: [
+        {
+          message: 'Unexpected asynchronous action in computed function.',
+          line: 5,
+          column: 41,
+          endLine: 5,
+          endColumn: 68
+        }
+      ]
     }
   ]
 })