1.0.0 • Published 4 years ago

global-var-manager v1.0.0

Weekly downloads
3
License
ISC
Repository
github
Last release
4 years ago

GlobalVar

一个js全局变量管理器

插件的设计初衷

我们经常需要在项目中使用到很多的全局变量例如:token令牌,但是全局变量可能是由不同的执行时间产生的这样就使得全局变量的产生和使用散乱在各个代码中而难于管理。

插件的设计思想 1. 统一项目中全局变量的存放、获取和删除。

构建配置抽离成npm包的意义

通用性
  1. 业务开发者无需关注构建配置
  2. 统一团队构建脚本
可维护性
  1. 构建配置合理的拆分
  2. README 文档、ChangeLog文档等
质量
  1. 冒烟测试、单元测试、测试覆盖率
  2. 持续集成

编辑器 1. Visual Studio Code

语言 1. javascript ES6

构建工具 1. "webpack": "^4.41.2" 2. "webpack-cli": "^3.3.9"

构建命令 1. npm run build

更新状态

版本时间
1.0.02019-11-07

库目录结构

未压缩版: global-var-manager.js
压缩版:global-var-manager.min.js

这样打包文件的体积将大幅缩小。


使用

使用npm

$ npm install global-var-manager --save

使用cdn

<script type="text/javascript" src="global-var-manager.min.js"></script>

示例:

// 导入插件
import GlobalVarManagerLibrary from 'global-var-manager'

// 初始化插件并传入需要在初始化时立马构建的全局变量对象
let globalVar = new GlobalVarManagerLibrary ({'token': 'test_123'})
// 获取value,如果没有token就用test
globalVar.getValue('token', 'test')

类: GlobalVar

构造器 Constructor

new GlobalVar(globalVarObject)

构造函数接收1个参数,第一个参数为可选

参数:

参数类型属性默认值描述
globalVarObjectObject可选{}初始化时立马构建的全局变量

示例

new GlobalVar({'token': 'test_123'})

操作函数

函数:getValue(key, defaultValueopt)

说明:获取某个全局变量的value,没有获取到将返回null

名称类型属性默认值描述
keystring获取全局变量的key
defaultValueopt*可选如果key没有对应的value那么返回传入的默认值

实例:

let globalVar = new GlobalVar({'token': 'test_123'})

globalVar.getValue('token', 'test')

函数:addOrUpdate(key, value)

说明:添加或者更新某个key的value

名称类型默认值描述
keystringkey键
value*value值

实例:

let GlobalVar = new GlobalVar({'token': 'test_123'})
GlobalVar.addOrUpdate('token', 'test')

函数:evict(key)

说明:删除某个key对应的全局变量

名称类型默认值描述
keystringkey键

实例:

let GlobalVar = new GlobalVar({'token': 'test_123'})
GlobalVar.evict('token')

函数:evictAll()

说明:清空所有全局变量

实例:

let GlobalVar = new GlobalVar({'token': 'test_123'})
GlobalVar.evictAll()