Vue3 学习笔记（十一）Vue生命周期

每个 Vue 组件实例在创建时都需要经历一系列的初始化步骤，比如设置好数据侦听，编译模板，挂载实例到 DOM，以及在数据改变时更新 DOM。在 Vue 实例生命周期的不同阶段被调用的函数， 被称为生命周期钩子。这些生命周期钩子允许你执行特定的逻辑，比如在组件创建之前、创建之后、更新之前、更新之后、销毁之前等。

如图所示：

以下是 Vue 3 生命周期钩子的详细解释：

1、onMounted 钩子

注册一个回调函数，在组件挂载完成后执行：

function onMounted(callback: () => void): void

组件在以下情况下被视为已挂载：

• 其所有同步子组件都已经被挂载 (不包含异步组件或 <Suspense> 树内的组件)。
• 其自身的 DOM 树已经创建完成并插入了父容器中。注意仅当根容器在文档中时，才可以保证组件 DOM 树也在文档中。

这个钩子通常用于执行需要访问组件所渲染的 DOM 树相关的副作用，或是在服务端渲染应用中用于确保 DOM 相关代码仅在客户端执行。

这个钩子在服务器端渲染期间不会被调用。

<script setup>

import {onMounted,ref} from 'vue'
const status = ref('init')
onMounted(() => {
	status.value = 'onMounted'
})
</script>




<template>
 
<p> {{"status = " + status}} </p>

</template>

2、onUpdated() 钩子

注册一个回调函数，在组件因为响应式状态变更而更新其 DOM 树之后调用。

function onUpdated(callback: () => void): void

调用时机：

父组件的更新钩子将在其子组件的更新钩子之后调用。

这个钩子会在组件的任意 DOM 更新后被调用，这些更新可能是由不同的状态变更导致的，因为多个状态变更可以在同一个渲染周期中批量执行 (考虑到性能因素)。

如果你需要在某个特定的状态更改后访问更新后的 DOM，请使用 nextTick()作为替代。

这个钩子在服务器端渲染期间不会被调用。

<script setup>
import { ref, onUpdated } from 'vue'

const count = ref(0)

onUpdated(() => {
  // 文本内容应该与当前的 `count.value` 一致
  console.log(document.getElementById('count').textContent)
})
</script>

<template>
  <button id="count" @click="count++">{{ count }}</button>
</template>

3、onUnmounted()

注册一个回调函数，在组件实例被卸载之后调用。

function onUnmounted(callback: () => void): void

一个组件在以下情况下被视为已卸载：

• 其所有子组件都已经被卸载。
• 所有相关的响应式作用 (渲染作用以及 setup() 时创建的计算属性和侦听器) 都已经停止。

可以在这个钩子中手动清理一些副作用，例如计时器、DOM 事件监听器或者与服务器的连接。

这个钩子在服务器端渲染期间不会被调用。

<script setup>
import { onMounted, onUnmounted } from 'vue'

let intervalId
onMounted(() => {
  intervalId = setInterval(() => {
    // ...
  })
})

onUnmounted(() => clearInterval(intervalId))
</script>

4、onBeforeMount()

注册一个钩子，在组件被挂载之前被调用。

function onBeforeMount(callback: () => void): void

当这个钩子被调用时，组件已经完成了其响应式状态的设置，但还没有创建 DOM 节点。它即将首次执行 DOM 渲染过程。

这个钩子在服务器端渲染期间不会被调用。

5、onBeforeUpdate()

在组件即将因为响应式状态变更而更新其 DOM 树之前调用

function onBeforeUpdate(callback: () => void): void

这个钩子可以用来在 Vue 更新 DOM 之前访问 DOM 状态。在这个钩子中更改状态也是安全的。

这个钩子在服务器端渲染期间不会被调用。

6、onBeforeUnmount()

在组件实例被卸载之前调用

function onBeforeUnmount(callback: () => void): void

当这个钩子被调用时，组件实例依然还保有全部的功能。

7、onErrorCaptured()

在捕获了后代组件传递的错误时调用。

function onErrorCaptured(callback: ErrorCapturedHook): void

type ErrorCapturedHook = (
  err: unknown,
  instance: ComponentPublicInstance | null,
  info: string
) => boolean | void

（1）、参数信息

这个钩子带有三个实参：错误对象、触发该错误的组件实例，以及一个说明错误来源类型的信息字符串。

在生产环境中，第三个参数 (info) 是一个缩短的代码，而不是含有完整信息的字符串。

生产环境的运行错误代码与其原始消息的映射表：

错误码	信息
0	setup function
1	render function
2	watcher getter
3	watcher callback
4	watcher cleanup function
5	native event handler
6	component event handler
7	vnode hook
8	directive hook
9	transition hook
10	app errorHandler
11	app warnHandler
12	ref function
13	async component loader
14	scheduler flush
15	component update
16	app unmount cleanup function
sp	serverPrefetch hook
bc	beforeCreate hook
c	created hook
bm	beforeMount hook
m	mounted hook
bu	beforeUpdate hook
u	updated
bum	beforeUnmount hook
um	unmounted hook
a	activated hook
da	deactivated hook
ec	errorCaptured hook
rtc	renderTracked hook
rtg	renderTriggered hook

生产环境的编译错误代码与其原始消息的映射表：

错误码	信息
0	Illegal comment.
1	CDATA section is allowed only in XML context.
2	Duplicate attribute.
3	End tag cannot have attributes.
4	Illegal ‘/’ in tags.
5	Unexpected EOF in tag.
6	Unexpected EOF in CDATA section.
7	Unexpected EOF in comment.
8	Unexpected EOF in script.
9	Unexpected EOF in tag.
10	Incorrectly closed comment.
11	Incorrectly opened comment.
12	Illegal tag name. Use ‘<’ to print ‘<’.
13	Attribute value was expected.
14	End tag name was expected.
15	Whitespace was expected.
16	Unexpected ‘<!–’ in comment.
17	Attribute name cannot contain U+0022 ("), U+0027 ('), and U+003C (<).
18	Unquoted attribute value cannot contain U+0022 ("), U+0027 ('), U+003C (<), U+003D (=), and U+0060 (`).
19	Attribute name cannot start with ‘=’.
20	Unexpected null character.
21	‘<?’ is allowed only in XML context.
22	Illegal ‘/’ in tags.
23	Invalid end tag.
24	Element is missing end tag.
25	Interpolation end sign was not found.
26	Legal directive name was expected.
27	End bracket for dynamic directive argument was not found. Note that dynamic directive argument cannot contain spaces.
28	v-if/v-else-if is missing expression.
29	v-if/else branches must use unique keys.
30	v-else/v-else-if has no adjacent v-if or v-else-if.
31	v-for is missing expression.
32	v-for has invalid expression.
33	key should be placed on the tag.
34	v-bind is missing expression.
35	v-on is missing expression.
36	Unexpected custom directive on outlet.
37	Mixed v-slot usage on both the component and nested . When there are multiple named slots, all slots should use syntax to avoid scope ambiguity.
38	Duplicate slot names found.
39	Extraneous children found when component already has explicitly named default slot. These children will be ignored.
40	v-slot can only be used on components or tags.
41	v-model is missing expression.
42	v-model value must be a valid JavaScript member expression.
43	v-model cannot be used on v-for or v-slot scope variables because they are not writable.
44	v-model cannot be used on a prop, because local prop bindings are not writable. Use a v-bind binding combined with a v-on listener that emits update:x event instead.
45	Error parsing JavaScript expression:
46	expects exactly one child component.
47	“prefixIdentifiers” option is not supported in this build of compiler.
48	ES module mode is not supported in this build of compiler.
49	“cacheHandlers” option is only supported when the “prefixIdentifiers” option is enabled.
50	“scopeId” option is only supported in module mode.
51	@vnode-* hooks in templates are no longer supported. Use the vue: prefix instead. For example, @vnode-mounted should be changed to @vue:mounted. @vnode-* hooks support has been removed in 3.4.
52	v-bind with same-name shorthand only allows static argument.
53	v-html is missing expression.
54	v-html will override element children.
55	v-text is missing expression.
56	v-text will override element children.
57	v-model can only be used on , and elements.
58	v-model argument is not supported on plain elements.
59	v-model cannot be used on file inputs since they are read-only. Use a v-on:change listener instead.
60	Unnecessary value binding used alongside v-model. It will interfere with v-model’s behavior.
61	v-show is missing expression.
62	expects exactly one child element or component.
63	Tags with side effect (

（2）、错误来源

错误可以从以下几个来源中捕获：

• 组件渲染
• 事件处理器
• 生命周期钩子
• setup() 函数
• 侦听器
• 自定义指令钩子
• 过渡钩子

（3）、错误传递规则

• 默认情况下，所有的错误都会被发送到应用级的 app.config.errorHandler，这样这些错误都能在一个统一的地方报告给分析服务。
• 如果组件的继承链或组件链上存在多个 errorCaptured 钩子，对于同一个错误，这些钩子会被按从底至上的顺序一一调用。这个过程被称为“向上传递”，类似于原生 DOM 事件的冒泡机制。
• 如果 errorCaptured 钩子本身抛出了一个错误，那么这个错误和原来捕获到的错误都将被发送到 app.config.errorHandler。
• errorCaptured 钩子可以通过返回 false 来阻止错误继续向上传递。即表示“这个错误已经被处理了，应当被忽略”，它将阻止其他的 errorCaptured 钩子或 app.config.errorHandler 因这个错误而被调用。