#### 簡單介紹
> Action 類似于 mutation,不同在于:
> 1、Action 提交的是 mutation,而不是直接變更狀態。
> 2、Action 可以包含任意異步操作。
看一個簡單的 action 示例:
~~~csharp
const store = new Vuex.Store({
state: {
count: 0
},
mutations: {
increment (state) {
state.count++
}
},
actions: {
increment (context) {
context.commit('increment')
}
}
})
~~~
可以看到,Action 函數接受一個 `context` 參數,注意,這個參數可不一般,它與 store 實例有著相同的方法和屬性,但是他們并不是同一個實例,后面學習 Modules 的時候會介紹它們為什么不一樣。
所以在這里可以使用 `context.commit` 來提交一個 mutation,或者通過 `context.state` 和 `context.getters` 來獲取 state 和 getters。
當然,為了代碼簡化,我們可以使用 ES2015 的 [參數解構](https://github.com/lukehoban/es6features#destructuring) 來直接展開,便于 `commit`、`state` 等多次調用。如下:
~~~bash
actions: {
increment ({ commit }) {
commit('increment')
}
}
~~~
#### 分發 Action
~~~bash
store.dispatch('increment')
~~~
Mutation 通過 `store.commit` 觸發,那么 Action 則通過 `store.dispatch` 方法觸發。
乍一眼看上去感覺多此一舉,我們直接分發 mutation 豈不更方便?實際上并非如此,還記得 mutation 必須同步執行這個限制么?Action 就不受約束!我們可以在 action 內部執行異步操作:
~~~jsx
actions: {
incrementAsync ({ commit }) {
setTimeout(() => {
commit('increment')
}, 1000)
}
}
~~~
和 Mutation 分發的方式異曲同工,這是注意這里是 `dispatch`:
~~~go
// 以載荷形式分發
store.dispatch('incrementAsync', {
amount: 10
})
// 以對象形式分發
store.dispatch({
type: 'incrementAsync',
amount: 10
})
~~~
來看一個更加實際的購物車示例,涉及到調用異步 API 和分發多重 mutation:
~~~dart
actions: {
checkout ({ commit, state }, products) {
// 把當前購物車的物品備份起來
const savedCartItems = [...state.cart.added]
// 發出結賬請求,然后樂觀地清空購物車
commit(types.CHECKOUT_REQUEST)
// 購物 API 接受一個成功回調和一個失敗回調
shop.buyProducts(
products,
// 成功操作
() => commit(types.CHECKOUT_SUCCESS),
// 失敗操作
() => commit(types.CHECKOUT_FAILURE, savedCartItems)
)
}
}
~~~
注意示例中正在進行一系列的異步操作,并且通過提交 mutation 來記錄 action 產生的副作用(即狀態變更)。
#### 組合 Action
> Action 通常是異步的,那么如何知道 action 什么時候結束呢?更重要的是,我們如何才能組合多個 action,以處理更加復雜的異步流程?
>
> 首先,你需要明白 `store.dispatch` 可以處理被觸發的 action 的處理函數返回的 Promise,并且 `store.dispatch` 仍舊返回 Promise:
不知道什么是 Promise 的,可以 [戳此了解下](https://www.liaoxuefeng.com/wiki/001434446689867b27157e896e74d51a89c25cc8b43bdb3000/0014345008539155e93fc16046d4bb7854943814c4f9dc2000)。
~~~jsx
actions: {
actionA ({ commit }) {
return new Promise((resolve, reject) => {
setTimeout(() => {
commit('someMutation')
resolve()
}, 1000)
})
}
}
~~~
調用:
~~~jsx
store.dispatch('actionA').then(() => {
// ...
})
~~~
當然,也可以這樣:
~~~jsx
actions: {
// ...
actionB ({ dispatch, commit }) {
return dispatch('actionA').then(() => {
commit('someOtherMutation')
})
}
}
~~~
我們還可以利用 [async / await](https://tc39.github.io/ecmascript-asyncawait/) 的方式組合 action :
~~~csharp
// 假設 getData() 和 getOtherData() 返回的是 Promise
actions: {
async actionA ({ commit }) {
commit('gotData', await getData())
},
async actionB ({ dispatch, commit }) {
await dispatch('actionA') // 等待 actionA 完成
commit('gotOtherData', await getOtherData())
}
}
~~~
> 一個 `store.dispatch` 在不同模塊中可以觸發多個 action 函數。在這種情況下,只有當所有觸發函數完成后,返回的 Promise 才會執行。
我們在實際項目中經常的會遇到這種情況,比如說你現在想要處理 B 事件,但是 B 事件需要一種資源才能進行,而這種資源必須通過 A 事件來獲得。這個時候,我們就需要組合 Action 來處理這些事件了。
#### 寫在最后
這一講官方講解得非常清晰,基本上沒啥難理解的,所以大部分都是直接引用了。當然,有任何的疑問都可以在下方留言和我一起溝通討論,謝謝!