Vue 3.0 選項(xiàng) 生命周期鉤子

注意

所有的生命周期鉤子自動綁定 this 上下文到實(shí)例中，因此你可以訪問數(shù)據(jù)，對 property 和方法進(jìn)行運(yùn)算。這意味著你不能使用箭頭函數(shù)來定義一個(gè)生命周期方法 (例如 created: () => this.fetchTodos()) 。這是因?yàn)榧^函數(shù)綁定了父上下文，因此 this 與你期待的組件實(shí)例不同，this.fetchTodos 的行為未定義。

#beforeCreate

• 類型：Function

• 詳細(xì)：

在實(shí)例初始化之后，數(shù)據(jù)觀測 (data observer) 和 event/watcher 事件配置之前被調(diào)用。

• 參考：生命周期圖示

#created

• 類型：Function

• 詳細(xì)：

在實(shí)例創(chuàng)建完成后被立即調(diào)用。在這一步，實(shí)例已完成以下的配置：數(shù)據(jù)觀測 (data observer)，property 和方法的運(yùn)算，watch/event 事件回調(diào)。然而，掛載階段還沒開始，$el property 目前尚不可用。

• 參考：生命周期圖示

#beforeMount

• 類型：Function

• 詳細(xì)：

在掛載開始之前被調(diào)用：相關(guān)的 render 函數(shù)首次被調(diào)用。

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：生命周期圖示

#mounted

• 類型：Function

• 詳細(xì)：

實(shí)例被掛載后調(diào)用，這時(shí) Vue.createApp({}).mount() 被新創(chuàng)建的 vm.$el 替換了。如果根實(shí)例掛載到了一個(gè)文檔內(nèi)的元素上，當(dāng) mounted 被調(diào)用時(shí) vm.$el 也在文檔內(nèi)。

注意 mounted 不會保證所有的子組件也都一起被掛載。如果你希望等到整個(gè)視圖都渲染完畢，可以在 mounted 內(nèi)部使用 vm。$nextTick：

  mounted() {
    this.$nextTick(function () {
      // 僅在渲染整個(gè)視圖之后運(yùn)行的代碼
    })
  }

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：生命周期圖示

#beforeUpdate

• 類型：Function

• 詳細(xì)：

數(shù)據(jù)更新時(shí)調(diào)用，發(fā)生在虛擬 DOM 打補(bǔ)丁之前。這里適合在更新之前訪問現(xiàn)有的 DOM，比如手動移除已添加的事件監(jiān)聽器。

該鉤子在服務(wù)器端渲染期間不被調(diào)用，因?yàn)橹挥谐醮武秩緯诜?wù)端進(jìn)行。

• 參考：生命周期圖示

#updated

• 類型：Function

• 詳細(xì)：

由于數(shù)據(jù)更改導(dǎo)致的虛擬 DOM 重新渲染和打補(bǔ)丁，在這之后會調(diào)用該鉤子。

當(dāng)這個(gè)鉤子被調(diào)用時(shí)，組件 DOM 已經(jīng)更新，所以你現(xiàn)在可以執(zhí)行依賴于 DOM 的操作。然而在大多數(shù)情況下，你應(yīng)該避免在此期間更改狀態(tài)。如果要相應(yīng)狀態(tài)改變，通常最好使用計(jì)算屬性或偵聽器取而代之。

注意，updated 不會保證所有的子組件也都一起被重繪。如果你希望等到整個(gè)視圖都重繪完畢，可以在 updated 里使用 vm.$nextTick：

  updated() {
    this.$nextTick(function () {
      // 僅在渲染整個(gè)視圖之后運(yùn)行的代碼
    })
  }

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：生命周期圖示

#activated

• 類型：Function

• 詳細(xì)：

被 keep-alive 緩存的組件激活時(shí)調(diào)用。

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：

• 動態(tài)組件 - keep-alive

#deactivated

• 類型：Function

• 詳細(xì)：

被 keep-alive 緩存的組件停用時(shí)調(diào)用。

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：

• 動態(tài)組件 - keep-alive

#beforeUnmount

• 類型：Function

• 詳細(xì)：

在卸載組件實(shí)例之前調(diào)用。在這個(gè)階段，實(shí)例仍然是完全正常的。

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：生命周期圖示

#unmounted

• 類型：Function

• 詳細(xì)：

卸載組件實(shí)例后調(diào)用。調(diào)用此鉤子時(shí)，組件實(shí)例的所有指令都被解除綁定，所有事件偵聽器都被移除，所有子組件實(shí)例被卸載。

該鉤子在服務(wù)器端渲染期間不被調(diào)用。

• 參考：生命周期圖示

#errorCaptured

• 類型：(err: Error, instance: Component, info: string) => ?boolean

• 詳細(xì)：

當(dāng)捕獲一個(gè)來自子孫組件的錯(cuò)誤時(shí)被調(diào)用。此鉤子會收到三個(gè)參數(shù)：錯(cuò)誤對象、發(fā)生錯(cuò)誤的組件實(shí)例以及一個(gè)包含錯(cuò)誤來源信息的字符串。此鉤子可以返回 false 以阻止該錯(cuò)誤繼續(xù)向上傳播。

TIP

你可以在此鉤子中修改組件的狀態(tài)。因此在捕獲錯(cuò)誤時(shí)，在模板或渲染函數(shù)中有一個(gè)條件判斷來繞過其它內(nèi)容就很重要；不然該組件可能會進(jìn)入一個(gè)無限的渲染循環(huán)。

錯(cuò)誤傳播規(guī)則

• 默認(rèn)情況下，如果全局的 config.errorHandler 被定義，所有的錯(cuò)誤仍會發(fā)送它，因此這些錯(cuò)誤仍然會向單一的分析服務(wù)的地方進(jìn)行匯報(bào)。
• 如果一個(gè)組件的繼承或父級從屬鏈路中存在多個(gè) errorCaptured 鉤子，則它們將會被相同的錯(cuò)誤逐個(gè)喚起。
• 如果此 errorCaptured 鉤子自身拋出了一個(gè)錯(cuò)誤，則這個(gè)新錯(cuò)誤和原本被捕獲的錯(cuò)誤都會發(fā)送給全局的 config.errorHandler。
• 一個(gè) errorCaptured 鉤子能夠返回 false 以阻止錯(cuò)誤繼續(xù)向上傳播。本質(zhì)上是說“這個(gè)錯(cuò)誤已經(jīng)被搞定了且應(yīng)該被忽略”。它會阻止其它任何會被這個(gè)錯(cuò)誤喚起的 errorCaptured 鉤子和全局的 config.errorHandler。

#renderTracked

• 類型：(e: DebuggerEvent) => void

• 詳細(xì)：

跟蹤虛擬 DOM 重新渲染時(shí)調(diào)用。鉤子接收 debugger event 作為參數(shù)。此事件告訴你哪個(gè)操作跟蹤了組件以及該操作的目標(biāo)對象和鍵。

• 用法：

  <div id="app">
    <button v-on:click="addToCart">Add to cart</button>
    <p>Cart({{ cart }})</p>
  </div>

  const app = Vue.createApp({
    data() {
      return {
        cart: 0
      }
    },
    renderTracked({ key, target, type }) {
      console.log({ key, target, type })
      /* 當(dāng)組件第一次渲染時(shí)，這將被記錄下來:
      {
        key: "cart",
        target: {
          cart: 0
        },
        type: "get"
      }
      */
    },
    methods: {
      addToCart() {
        this.cart += 1
      }
    }
  })

  
  app.mount('#app')

#renderTriggered

• 類型：(e: DebuggerEvent) => void

• 詳細(xì)：

當(dāng)虛擬 DOM 重新渲染為 triggered.Similarly 為renderTracked，接收 debugger event 作為參數(shù)。此事件告訴你是什么操作觸發(fā)了重新渲染，以及該操作的目標(biāo)對象和鍵。

• 用法：

  <div id="app">
    <button v-on:click="addToCart">Add to cart</button>
    <p>Cart({{ cart }})</p>
  </div>

  const app = Vue.createApp({
    data() {
      return {
        cart: 0
      }
    },
    renderTriggered({ key, target, type }) {
      console.log({ key, target, type })
    },
    methods: {
      addToCart() {
        this.cart += 1
        /* 這將導(dǎo)致renderTriggered調(diào)用
          {
            key: "cart",
            target: {
              cart: 1
            },
            type: "set"
          }
        */
      }
    }
  })

  
  app.mount('#app')