---
title: "onNuxtReady"
description: "onNuxtReady 组合式函数允许在你的应用完成初始化后运行一个回调。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/api/utils/on-nuxt-ready"
---
# onNuxtReady

> onNuxtReady 组合式函数允许在你的应用完成初始化后运行一个回调。

::important
`onNuxtReady` 仅在客户端运行。   

它非常适合运行那些不应阻塞应用初始渲染的代码。
::

```ts [app/plugins/ready.client.ts]
export default defineNuxtPlugin(() => {
  onNuxtReady(async () => {
    const myAnalyticsLibrary = await import('my-big-analytics-library')
    // 使用 myAnalyticsLibrary 做一些事情
  })
})
```

即使在应用已经初始化之后运行它也是“安全”的。在这种情况下，代码将被注册为在下一个空闲回调中运行。

---

- [源码](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ready.ts)


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.