TypeScript在Vuex4中使用TS实战分享
简介
虽然TypeScript知识点学了很多，但是在实际项目中很多小伙伴还并不知道怎么用，今天笔者结合Vuex4来使用TypeScript实战一下。
本文分vuex4类型 Api分析和vuex4实战两部分讲述。
首先我们来分析下 vuex4 的类型 Api
createStore
我们可以先看看createStore方法，发现它需要传递一个泛型，并且这个泛型会应用到state上。
export function createStore<S>(options: StoreOptions<S>): Store<S>;
export interface StoreOptions<S> {
state?: S | (() => S);
getters?: GetterTree<S, S>;
actions?: ActionTree<S, S>;
mutations?: MutationTree<S>;
modules?: ModuleTree<S>;
plugins?: Plugin<S>[];
strict?: boolean;
devtools?: boolean;
}GetterTree
我们可以看到getters的类型GetterTree接收了两个泛型。
export interface GetterTree<S, R> {
[key: string]: Getter<S, R>;
}
这两个泛型分别应用在本模块state上和根state上。
export type Getter<S, R> = (state: S, getters: any, rootState: R, rootGetters: any) => any;
MutationTree
我们可以看到mutations的类型MutationTree只接收了一个泛型。
export interface MutationTree<S> {
[key: string]: Mutation<S>;
}并且这个泛型只应用到本模块state上。
export type Mutation<S> = (state: S, payload?: any) => any;
ActionTree
我们可以看到actions的类型ActionTree接收了两个泛型。
export interface ActionTree<S, R> {
[key: string]: Action<S, R>;
}并且也将这两个泛型分别应用在本模块state上和根state上。我们还可以看到，由于action支持对象和方法形式的写法，所以Action的类型是ActionHandler和ActionObject的联合类型。
export type Action<S, R> = ActionHandler<S, R> | ActionObject<S, R>;
export type ActionHandler<S, R> = (this: Store<R>, injectee: ActionContext<S, R>, payload?: any) => any;
export interface ActionContext<S, R> {
dispatch: Dispatch;
commit: Commit;
state: S;
getters: any;
rootState: R;
rootGetters: any;
}
ModuleTree
我们可以看到modules的类型ModuleTree只接收了一个泛型。并且将这个泛型传递到了Module里面。
export interface ModuleTree<R> {
[key: string]: Module<any, R>;
}我们可以发现，module的类型和createStore的StoreOptions是非常像的。
因为模块本身也有自己的state、getters、actions、mutations、modules
export interface Module<S, R> {
namespaced?: boolean;
state?: S | (() => S);
getters?: GetterTree<S, R>;
actions?: ActionTree<S, R>;
mutations?: MutationTree<S>;
modules?: ModuleTree<R>;
}
了解了vuex4类型 Api接下来我们就进入到实战环节了。
实战
首先我们需要使用vuecli创建一个TypeScript的项目。
整体目录结构
笔者store整体目录结构如下：
index.ts和以前的还是一样，用来创建根store并导出根store。interfaces.ts用来存放store的类型。modules.ts和以前的还是一样，用来存放模块。
首先定义根state的类型
// interfaces.ts
type Info = { address: string };
export interface IRootState {
name: string;
age: number;
info: Info;
}在创建store的时候将根state的类型传递进去。
// index.ts
import { createStore, Store } from "vuex";
import { InjectionKey } from "vue";
import { IRootState } from "./interfaces";
export default createStore<IRootState>({
state: {
name: "root",
age: 0,
info: { address: "" },
},
getters: {
getRootName(state) {
return state.name;
},
getRootInfo(state) {
return state.info;
},
},
mutations: {},
actions: {},
});并且需要导出key
// index.ts export const key: InjectionKey<Store<IRootState>> = Symbol();
在Vue实例使用store的时候将key一并传入。
// main.ts
import store, { key } from "@/store";
createApp(App).use(store, key).mount("#app");
在vue组件使用
这样我们在vue组件就能享受到TypeScript的优势啦。
注意这里的useStore()，也需要我们把key传递进去。
import { useStore } from "vuex";
import { key } from "@/store";
setup() {
const store = useStore(key);
return {
rootName: store.state.name,
};
},可以看到，我们使用state的时候就会被自动提示啦。
并且当你使用不存在的属性时会在我们编写代码的时候就会直接报错提示。
相较js，大大提高了开发效率不说，还减少了bug。
自定义useStore()方法
如果觉得每次useStore()，还需要我们把key传递进去麻烦的话，我们可以创建自己的useStore()方法。
// index.ts
import { useStore as baseUseStore } from "vuex";
export function useStore() {
return baseUseStore(key);
}
这样我们在vue组件使用store的时候引入自己的useStore方法就可以啦。
import { useStore } from "@/store";
setup() {
const store = useStore();
return {
rootName: store.state.name,
};
},
我们知道，在实际项目中只创建一个根store是远远不够的。一般我们都会使用modules。下面笔者介绍下怎么使用modules。
modules的使用
模块的类型是Module，并且需要传递本模块state类型和根state类型。
本模块state类型需要传递进去我们可以理解，但是为什么要传递根state类型呢？
因为我们的getters和actions参数里面是有rootState的，所以需要引入根state类型。
// modeuls/test1.ts
import { Module } from "vuex";
import { IRootState, ITest1State } from "../interfaces";
const Test1: Module<ITest1State, IRootState> = {
state: {
name: "test1",
count: 0,
},
getters: {
getTest1Name(state) {
return state.name;
},
getAllName(state, rootState) {
return state.name + rootState.age;
},
},
};
export default Test1;创建好模块后我们需要在根store里面引入进去，引入方式和以前还是一样。
并且我们需要把模块的state类型一并传递到InjectionKey中和根state类型形成交叉类型，并重新生成key。
// index.ts
import { createStore, Store, useStore as baseUseStore } from "vuex";
import { InjectionKey } from "vue";
import { IRootState, ITest1State } from "./interfaces";
import test1 from "./modeuls/test1";
export default createStore<IRootState>({
// ...
modules: {
test1: test1,
// ...多个模块，类似
},
});
// 定义模块类型
type Modules = {
test1: ITest1State;
// ...多个模块，类似
};
// 使用交叉类型形成新的key
export const key: InjectionKey<Store<IRootState & Modules>> = Symbol();我们来看看在vue组件中的使用效果。
我们可以发现，当我们使用state的时候，test1模块也会被提示出来
并且它里面的属性也会被直接提示出来
好了，实战环节就讲述的差不多了，小伙伴们时候都懂了呢？
总结
虽然vuex4对TypeScript有了很好的支持，但是笔者觉得还是不够的。
比如 使用麻烦，每次需要定义一个key，还需要把可以传递到vue的use方法里面，并且在使用useStore的时候也还需要将key传递进去，无疑增加了开发成本。
其次，这样的配置并不会对getters、mutations、actions生效，只会对state有提示。
和pinia比起来，整体使用体验还是会差很多。如果想学习pinia，并想了解pinia和vuex区别的话可以看看TypeScript Pinia实战分享(Vuex和Pinia对比梳理总结)一文。
到此这篇关于TypeScript在Vuex4中使用TS实战分享的文章就介绍到这了,更多相关TypeScript Vuex4内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要给大家介绍了关于利用JS实现一个同Excel表现的智能填充算法的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2018-08-08
这篇文章主要介绍了小程序使用wxs解决wxml保留2位小数问题，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-12-12
本文给大家简单介绍了下javascript中的字符串和数组，都是些十分基础的知识，小伙伴们要学好javascript，一定要把这2点理解清楚。2015-06-06
这篇文章主要为大家详细介绍了如何利用JavaScript和Canvas实现酷炫的粒子和流星动画效果，文中的示例代码讲解详细，感兴趣的小伙伴可以跟随小编一起学习一下2023-01-01
在JavaScript中虽没有类似的方法，但我们可以利用字符串的replace方法自定义字符串的格式化方法。下面通过本文给大家分享使用JS在HTML中自定义字符串格式化的方法，需要的的朋友参考下吧2017-07-07
ES6是JavaScript语言的主要增强,允许我们编写程序,ES6适用于复杂的应用程序,尽管ES5和ES6在本质上有一些相似之处,但它们之间也有许多不同之处,下面这篇文章主要给大家介绍了关于ES5和ES6区别的相关资料,需要的朋友可以参考下2023-05-05
使用js实现几秒以后倒计时跳转，这个在某些特殊情况下还是比较实用的，下面为大家介绍下具体的实现步骤，感兴趣的朋友不要错过2013-12-12
javascript中的遍历方法有很多,今天主要总结一下这些遍历方法如何跳出循环,这篇文章主要给大家介绍了关于如何跳出map或者foreach循环的相关资料,需要的朋友可以参考下2023-11-11
下面小编就为大家带来一篇javascript浏览器用户代理检测脚本实现方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-10-10
设置iframe的document.designMode后仅Firefox中其body.innerHTML为br
设置iframe的document.designMode为On可以让其可编辑，一般用在富文本编辑器组件中。这里仅列出各浏览器差异2012-02-02
最新评论