Vuex を安全に使うための型定義
Meguro.es #13 @ ラクスル
@ktsn
Vuex?
状態とミューテーション
const store = new Vuex.Store({
// 状態
state: {
count: 0
},
// ミューテーション
mutations: {
increment (state, payload) {
state.count += payload.amount
}
}
})
// 使う側
store.commit('increment', { amount: 1 })
console.log(store.state.count) // -> 1
モジュール
// カウンターモジュール
const counter = {
namespaced: true,
state: { /* ... */ },
mutations: { /* ... */ }
}
const store = new Vuex.Store({
modules: { counter }
})
store.commit('counter/increment', { amount: 1 })
コンポーネントで使う
import Vue from 'vue'
import { mapState, mapMutations } from 'vuex'
export default Vue.extend({
// increment を this に生やす
methods: mapMutations(['increment']),
// count を this に生やす
computed: mapState(['count']),
created () {
// ミューテーション
this.increment({ amount: 1 })
// 状態
console.log(this.count)
}
})
型付けがつらい
const store = new Vuex.Store({
/* ... */
mutations: {
increment (state, payload: { amount: number }) {
state.count += payload.amount
}
}
})
// 有効な mutation 名がわからない
// payload の型がわからない
store.commit('increment', 123)
namespace の型付けが困難
定義するとき
increment (state, payload) { ... }
呼び出すとき
commit('counter/increment', payload)
無理では?
ゼロから型付けできる API で作ったほうが良い
試しに書いてみたら意外にできた
// 状態: 普通に状態の型を定義
interface CounterState {
count: number
}
// ミューテーション
// キー: ミューテーション名
// 値: ペイロードの型
interface CounterMutations {
increment: { amount: number }
}
まず状態とミューテーションの
インターフェースを定義
DefineModule
import { DefineModule } from 'vuex'
// モジュールの型注釈に DefineModule を指定
const counter: DefineModule<CounterState, {}, CounterMutations, {}> = {
// namespace 付けても良い
namespaced: true,
state: {
count: 0
},
mutations: {
// 型注釈付けなくても全部型がついてる
increment (state, payload) {
state.count += payload.amount
}
}
}
createNamespacedHelpers
import { createNamespacedHelpers } from 'vuex'
// 型パラメーターに状態、ミューテーションのインターフェースを渡す
// 引数には実際の namespace の値を渡す
export const counterHelpers
= createNamespacedHelpers<CounterState, {}, CounterMutations, {}>('counter')
// コンポーネント内でヘルパーを使う
export default Vue.extend({
methods: counterHelpers.mapMutations([
'increment' // 名前が正しいかチェックされる!
]),
created () {
// ちゃんと型付けされる!
this.increment({ amount: 1 })
}
})
型安全バンザイ 🎉
Vuex を安全に使うための型定義 #meguroes
By katashin
Vuex を安全に使うための型定義 #meguroes
- 3,221