Vue3 <script setup> 中,async 通常不能省略

在Vue3的<script setup>中,async关键字的使用取决于场景:

  1. 使用await时必须加async;
  2. 使用.then()或同步操作时可省略;
  3. Vue3.3+支持顶层await无需async。

async的作用是让函数返回Promise并允许使用await。


若代码含await却省略async会导致语法错误。


文中提供了具体代码示例说明何时必须或可以省略async关键字。


<script setup lang="ts"> 中,async 通常不能省略,但有特殊情况。


1. 需要 async 的情况(最常见)

当你需要在 onMountedwatchcomputed 等钩子或响应式API中使用 await 时:

TypeScript 复制代码
// ✅ 必须要有 async
onMounted(async () => {
  const data = await fetchData()  // 使用 await
  result.value = data
})

// ✅ 必须要有 async  
const fetchData = async () => {
  const response = await axios.get('/api/data')
  return response.data
}

2. 可以省略 async 的情况

方式一:使用 .then() 替代 await

TypeScript 复制代码
// ✅ 可以省略 async
onMounted(() => {
  fetchData().then(data => {
    result.value = data
  })
})

方式二:不使用异步操作

TypeScript 复制代码
// ✅ 可以省略 async
onMounted(() => {
  result.value = '立即设置的值'
})

3. 针对你的原始代码

TypeScript 复制代码
// 原始代码(必须要有 async)
onMounted(async () => {
  result.value = await new Promise<string>((resolve) => {
    setTimeout(() => {
      resolve('hello world')
    }, 10000)
  })
})

// 等价改写(可以省略 async)
onMounted(() => {
  new Promise<string>((resolve) => {
    setTimeout(() => {
      resolve('hello world')
    }, 10000)
  }).then(value => {
    result.value = value  // 使用 .then() 替代 await
  })
})

4. async 的作用

async 关键字的作用是:

  1. 让函数返回一个 Promise

  2. 允许在函数内部使用 await

  3. 自动包装返回值为 Promise

TypeScript 复制代码
// 这两个函数是等价的
async function foo() { return 1 }
function foo() { return Promise.resolve(1) }

5. ue 3.3+ 的特殊情况

Vue 3.3+ 引入了 <script setup> 的顶层 await 支持:

TypeScript 复制代码
<script setup lang="ts">
// ✅ Vue 3.3+ 支持,不需要 async
const data = await fetchData()  // 顶层 await

// 但生命周期钩子内仍需 async
onMounted(async () => {
  // ...
})
</script>

总结:

场景 是否需要 async
使用 await 必须
使用 .then() 不需要
同步操作 不需要
Vue 3.3+ 顶层 await 不需要(在顶层)

在你的代码中,由于使用了 await,所以 async 不能省略。 如果省略了 async,但保留了 await,会导致语法错误。

相关推荐
大家的林语冰2 小时前
《前端周刊》尤大开源 Vite+ 全家桶,前端工业革命启动;尤大爆料 Void 云服务新产品,Vite 进军全栈开发;ECMA 源码映射规范......
前端·javascript·vue.js
M ? A3 小时前
Vue 迁移 React 实战:VuReact 一键自动化转换方案
前端·vue.js·经验分享·react.js·开源·自动化·vureact
Burt3 小时前
我的 2026 全栈选型:Vue3 + Elysia + Bun + AlovaJS
vue.js·全栈·bun
小锋java12344 小时前
SpringBoot 4 + Spring Security 7 + Vue3 前后端分离项目设计最佳实践
java·vue.js·spring boot
一 乐4 小时前
校园线上招聘|基于springboot + vue校园线上招聘系统(源码+数据库+文档)
java·数据库·vue.js·spring boot·论文·毕设·校园线上招聘系统
LanceJiang4 小时前
从输入 URL 到页面:一个 Vue 项目的“奇幻漂流”
vue.js
码喽7号5 小时前
vue学习四:Axios网络请求
前端·vue.js·学习
像素之间6 小时前
为什么运行时要加set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve
前端·javascript·vue.js
M ? A6 小时前
Vue转React实战:defineProps精准迁移实战
前端·javascript·vue.js·经验分享·react.js·开源·vureact
JokerLee...7 小时前
大屏自适应方案
前端·vue.js·大屏端