阿卡不拉阿卡不拉
Vue3
阿卡的博客
Vue3
阿卡的博客
  • Vue3

    • 快速入门

      • 搭建工程 👌
      • 模板语法
      • 响应式基础
      • 响应式常用 API
      • 计算属性
      • 类与样式绑定
      • 条件和列表渲染
      • 事件处理
      • 表单处理
      • 生命周期
      • 侦听器
      • 组件介绍
      • Props
      • 自定义事件
      • 组件v-model
      • 插槽
      • 前端路由介绍
      • KeepAlive内置组件
      • 状态管理库
      • 组件库介绍
    • 深入本质

      • 虚拟DOM本质
      • 模板的本质
      • 组件树和虚拟DOM树
      • 数据拦截的本质
      • 响应式数据的本质
      • 响应式的本质
      • 响应式和组件渲染
      • 实现响应式系统 1
      • 实现响应式系统 2
      • 图解EFFECT
      • 实现响应式系统 3
      • 手写computed
      • 手写watch
      • 指令的本质
      • 插槽的本质
      • v-model的本质
      • setup 语法标签
      • 组件生命周期
      • keepalive 生命周期
      • keepalive的本质
      • key的本质
    • 细节补充

      • 【Vue】属性透传
      • 【Vue】依赖注入
      • 【Vue】组合式函数 👌
      • 【Vue】自定义指令
      • 【Vue】插件
      • 【Vue】Transition
      • 【Vue】TransitionGroup
      • 【Vue】Teleport
      • 【Vue】异步组件
      • 【Vue】Suspense
      • 【Router】路由模式
      • 【Router】路由零碎知识
      • 【Router】路由匹配语法
      • 【Router】路由组件传参
      • 【Router】内置组件和函数
      • 【Router】导航守卫
      • 【Router】过渡特效
      • 【Router】滚动行为
      • 【Router】动态路由
      • 【State】通信方式总结
      • 【State】Pinia 自定义插件
      • 【场景】封装树形组件
      • 【场景】自定义 ref 实现防抖
      • 【场景】懒加载
      • 【场景】虚拟列表
      • 【场景】虚拟列表优化
      • 【第三方库】VueUse
      • 【第三方库】vuedragable
      • 【第三方库】vue-drag-resize
      • 【第三方库】vue-chartjs
      • 【第三方库】vuelidate
      • 【第三方库】vue3-lazyload
      • 【场景】Websocket 聊天室
      • 【Vite】✨ 认识 Vite👌
      • 【Vite】配置文件 👌
      • 【Vite】✨ 依赖预构建 👌
      • 【Vite】构建生产版本 👌
      • 【Vite】环境变量与模式
      • 【Vite】CLI
      • 【Vite】Vite 插件
  • 笔面试

    • HTML

      • HTML 面试题汇总
      • 文档声明
      • 语义化
      • W3C 标准组织
      • SEO
      • iframe
      • 微格式
      • 替换元素
      • 页面可见性
    • CSS

      • CSS 面试题汇总
      • CSS 单位总结
      • 居中方式总结
      • 隐藏元素方式总结
      • 浮动
      • 定位总结
      • BFC
      • CSS 属性计算过程
      • CSS 层叠继承规则总结
      • @import 指令
      • CSS3 calc 函数
      • CSS3 媒体查询
      • 过渡和动画事件
      • 渐进增强和优雅降级
      • CSS3 变形
      • 渐进式渲染
      • CSS 渲染性能优化
      • 层叠上下文
      • CSS3 遮罩
    • JavaScript

      • JavaScript 面试题汇总
      • ✨ let、var、const 的区别
      • JS中的数据类型
      • 包装类型
      • 数据类型的转换
      • 运算符
      • ✨ 原型链
      • ✨ this 指向
      • ✨ 垃圾回收与内存泄漏
      • ✨ 执行栈和执行上下文
      • ✨ 作用域和作用域链
      • ✨ 闭包
      • DOM 事件的注册和移除
      • DOM 事件的传播机制
      • 阻止事件默认行为
      • 递归
      • ✨ 属性描述符
      • class 和构造函数区别
      • 浮点数精度问题
      • 严格模式
      • ✨ 函数防抖和节流
      • ✨ WeakSet 和 WeakMap
      • ✨ 深浅拷贝
      • 函数柯里化
      • Node 事件循环
      • 尺寸和位置
    • 浏览器

      • 浏览器面试题汇总
      • ✨ 浏览器的渲染流程
      • ✨ 资源提示关键词
      • 浏览器的组成部分
      • IndexedDB
      • ✨ File API
      • ✨ 浏览器缓存
      • ✨ 浏览器跨标签页通信
      • Web Worker
    • 网络

      • 网络面试题汇总
      • 五层网络模型 👌
      • 常见请求方法 👌
      • ✨cookie👌
      • 面试题
      • 加密
      • ✨JWT👌
      • ✨ 同源策略及跨域问题 👌
      • 文件上传
      • ✨ 输入 url 地址之后
      • 文件下载
      • ✨ session
      • ✨ TCP
      • ✨ CSRF 攻击
      • ✨XSS 攻击 👌
      • ✨ 网络性能优化
      • 断点续传
      • 域名和 DNS
      • SSL、TLS、HTTPS 的关系
      • ✨ HTTP 各版本差异 👌
      • HTTP 缓存协议
      • ✨ WebSocket
    • 工程化

      • CMJ 和 ESM
      • npx
      • ESLint
    • Vue2

      • Vue 面试题汇总相关
      • 组件通信方式总结
      • 虚拟 DOM
      • v-model
      • 数据响应式原理
      • diff
      • 生命周期详解
      • computed
      • 过滤器
      • 作用域插槽
      • 过度和动画
      • 优化
      • keep-alive
      • 长列表优化
      • 其他 API
      • 模式和环境变量
      • 更多配置
      • 更多命令
      • 嵌套路由
      • 路由切换动画
    • Vue3

      • ✨ Vue3 整体变化 👌
      • ✨ Vue3 响应式变化 👌
      • ✨ nextTick 实现原理 👌
      • 两道代码题 👌
      • Vue 运行机制
      • 渲染器核心功能
      • 事件绑定与更新

【State】Pinia 自定义插件

在 Pinia 中,可以为仓库添加插件,通过插件可以扩展以下内容:

  • 为 store 添加新的属性
  • 定义 store 时增加新的选项
  • 为 store 增加新的方法
  • 包装现有的方法
  • 改变甚至取消 action
  • 实现副作用,如本地存储

首先建议插件单独放置于一个目录下,一个插件其实就是一个方法:

// 几个插件示例
export function myPiniaPlugin1() {
    // 给所有的仓库添加了一条全局属性
    return {
        secret: "the cake is a lie",
    };
}

export function myPiniaPlugin2(context) {
    // console.log(context);
    const { store } = context;
    // 在仓库上扩展状态
    store.test = "this is a test";
}

/**
 * 给特定的仓库来扩展内容
 * @param {*} param0
 */
export function myPiniaPlugin3({ store }) {
    if (store.$id === "counter") {
        // 为当前 id 为 counter 的仓库来扩展属性
        return {
            name: "my name is pinia",
        };
    }
}

/**
 * 重置仓库状态
 */
export function myPiniaPlugin4({ store }) {
    // 我们首先可以将初始状态深拷贝一份
    const state = deepClone(store.$state);
    // 提供一个 reset 方法可以重置仓库状态
    store.reset = () => {
        store.$patch(deepClone(state));
    };
}

每个插件扩展内容,其实就是对仓库进行内容扩展。如果想要针对某一个仓库进行内容扩展,可以通过 context.store.$id 来指定某一个仓库来扩展内容。

插件书写完毕后,需要通过 pinia 实例对插件进行一个注册操作:

// 引入自定义插件
import {
    myPiniaPlugin1,
    myPiniaPlugin2,
    myPiniaPlugin3,
    myPiniaPlugin4,
} from "./plugins";
// 注册
pinia.use(myPiniaPlugin1);
pinia.use(myPiniaPlugin2);
pinia.use(myPiniaPlugin3);
pinia.use(myPiniaPlugin4);

之后就可以在 store 上使用插件添加的状态或者方法,例如:

// main.js
import { createApp } from "vue";
import { createPinia } from "pinia";
import App from "./App.vue";

// 自定义插件
// 在该自定义插件中,扩展了一个数据和方法
function myPlugin({ store }) {
    store.$state.pluginData = "这是插件添加的数据";

    store.pluginMethod = function () {
        console.log("这是插件添加的方法");
    };
}

const pinia = createPinia();
// 注册自定义插件
pinia.use(myPlugin);

const app = createApp(App);
app.use(pinia);
app.mount("#app");
// store.js
import { defineStore } from "pinia";

export const useMyStore = defineStore("myStore", {
    state: () => ({
        myData: "初始数据",
    }),
    actions: {
        usePluginMethod() {
            this.pluginMethod(); // 使用插件提供的方法
            console.log(this.pluginData); // 访问插件提供的数据
        },
    },
});

实战案例

书写一个插件,该插件用来记录操作日志和捕获错误。

// logPlugin.js
/**
 * 记录操作日志和捕获错误的插件方法
 * @param {*} param0
 */
export function logPlugin({ store }) {
    // 监听所有的action的行为, 当触发了某一个action时会执行传入的回调函数
    /**
     * @param {String} name action名称
     * @param {*} args action执行时传入的参数
     * @param {Function} after action执行完后的回调函数
     * @param {Function} onError action执行出错时的回调函数
     */
    store.$onAction(({ name, args, after, onError }) => {
        const startTime = Date.now();
        console.log(
            `Action ${name} started with arguments: ${JSON.stringify(args)}`
        );

        // action 执行成功后的回调函数
        // result 为 action 返回的结果
        after((result) => {
            // 记录结束时间
            const endTime = Date.now();
            console.log(
                `Action ${name} finished in ${
                    endTime - startTime
                }ms with result: ${JSON.stringify(result)}`
            );
        });

        onError((error) => {
            // 记录结束时间
            const endTime = Date.now();
            console.log(
                `Action ${name} finished in ${
                    endTime - startTime
                }ms with error: ${JSON.stringify(error)}`
            );
        });
    });
}

第三方插件

在 npm 官网搜索关键字 “pinia plugin”,之后根据文档使用。

演示 pinia-plugin-persistedstate 插件的使用。

最近更新:: 2025/7/9 07:29
Contributors: AK
Prev
【State】通信方式总结
Next
【场景】封装树形组件