Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

useRuntimeHook

源码
在 Nuxt 应用中注册一个运行时钩子，并确保在作用域销毁时正确释放它。

Maschinelle Übersetzung ·0 % geprüft

此组合函数在 Nuxt v3.14 及以上版本中可用。
signature
function useRuntimeHook<THookName extends keyof RuntimeNuxtHooks> (
  name: THookName,
  fn: RuntimeNuxtHooks[THookName] extends HookCallback ? RuntimeNuxtHooks[THookName] : never,
): void

用法

参数

  • name：要注册的运行时钩子的名称。你可以在此处查看完整的 runtime Nuxt hooks 列表。
  • fn：钩子触发时执行的回调函数。函数签名因钩子名称而异。

返回值

该组合函数不返回值，但会在组件作用域销毁时自动注销该钩子。

示例

<script setup lang="ts">
// 注册一个钩子，每当链接被预取时执行，
// 并且当组件卸载时会自动清理（不会再次调用）
useRuntimeHook('link:prefetch', (link) => {
  console.log('正在预取', link)
})
</script>