useRuntimeHook
在 Nuxt 应用中注册一个运行时钩子,并确保在作用域被销毁时正确清理。
此组合式函数适用于 Nuxt v3.14 及以上版本。
signature
function useRuntimeHook<THookName extends keyof RuntimeNuxtHooks>(
name: THookName,
fn: RuntimeNuxtHooks[THookName] extends HookCallback ? RuntimeNuxtHooks[THookName] : never
): void
用法
参数
name
: 要注册的运行时钩子的名称。你可以在这里查看完整的运行时 Nuxt 钩子列表。fn
: 当钩子被触发时要执行的回调函数。函数签名根据钩子名称而异。
返回值
该组合式函数不返回任何值,但会在组件作用域被销毁时自动注销该钩子。
示例
pages/index.vue
<script setup lang="ts">
// 注册一个在每次预取链接时运行的钩子,且在组件卸载时会自动清理(不会再次调用)
useRuntimeHook('link:prefetch', (link) => {
console.log('预取链接:', link)
})
</script>