📅  最后修改于: 2023-12-03 15:27:45.408000             🧑  作者: Mango
在使用 Tampermonkey、Greasemonkey 等脚本管理器编写用户脚本时,我们常常需要使用到内爆(GM_deleteValue()
、GM_setValue()
、GM_listValues()
、GM_getValue()
)函数来进行数据存取、数据删除等操作,这些函数是 GM API(Greasemonkey API) 提供的常用函数,使用简单且非常方便。
使用该函数可以删除本地存储的某个键值对应的数据,函数调用格式如下:
GM_deleteValue(name)
其中,name
表示需要删除数据的键名。例如:
// 在脚本中删除一个名为 'foo' 的键值对应的数据
GM_deleteValue('foo')
使用该函数可以将数据存储到本地,函数调用格式如下:
GM_setValue(name, value)
其中,name
表示存储的键名,value
表示存储的键值。例如:
// 在脚本中将一个名为 'foo' 的键值对应的数据存储到本地
GM_setValue('foo', 'bar')
使用该函数可以获取存储在本地的所有键值对的键名,函数调用格式如下:
GM_listValues()
该函数返回一个数组,数组中的每个元素都是存储的键名。例如:
// 在脚本中获取所有的键名并输出
console.log(GM_listValues())
使用该函数可以获取本地存储的某个键值对应的数据,函数调用格式如下:
GM_getValue(name[, defaultValue])
其中,name
表示需要读取数据的键名,defaultValue
表示如果该数据不存在时需要返回的默认值。例如:
// 在脚本中获取一个名为 'foo' 的键值对应的数据
const fooData = GM_getValue('foo')
需要注意的是,如果该键名对应的数据不存在且没有设置默认值,则会返回 undefined
。因此,建议在调用该函数时,始终设置默认值。例如:
// 在脚本中获取一个名为 'foo' 的键值对应的数据
// 如果该数据不存在,则返回默认值 'default'
const fooData = GM_getValue('foo', 'default')
以上为 GM API 提供的内爆函数介绍,使用简单方便,可以帮助我们更好地管理用户脚本的本地数据。