📜  节点 | GM 内爆()函数(1)

📅  最后修改于: 2023-12-03 15:27:45.408000             🧑  作者: Mango

节点 | GM 内爆()函数

在使用 Tampermonkey、Greasemonkey 等脚本管理器编写用户脚本时,我们常常需要使用到内爆(GM_deleteValue()GM_setValue()GM_listValues()GM_getValue())函数来进行数据存取、数据删除等操作,这些函数是 GM API(Greasemonkey API) 提供的常用函数,使用简单且非常方便。

GM_deleteValue()

使用该函数可以删除本地存储的某个键值对应的数据,函数调用格式如下:

GM_deleteValue(name)

其中,name 表示需要删除数据的键名。例如:

// 在脚本中删除一个名为 'foo' 的键值对应的数据
GM_deleteValue('foo')
GM_setValue()

使用该函数可以将数据存储到本地,函数调用格式如下:

GM_setValue(name, value)

其中,name 表示存储的键名,value 表示存储的键值。例如:

// 在脚本中将一个名为 'foo' 的键值对应的数据存储到本地
GM_setValue('foo', 'bar')
GM_listValues()

使用该函数可以获取存储在本地的所有键值对的键名,函数调用格式如下:

GM_listValues()

该函数返回一个数组,数组中的每个元素都是存储的键名。例如:

// 在脚本中获取所有的键名并输出
console.log(GM_listValues())
GM_getValue()

使用该函数可以获取本地存储的某个键值对应的数据,函数调用格式如下:

GM_getValue(name[, defaultValue])

其中,name 表示需要读取数据的键名,defaultValue 表示如果该数据不存在时需要返回的默认值。例如:

// 在脚本中获取一个名为 'foo' 的键值对应的数据
const fooData = GM_getValue('foo')

需要注意的是,如果该键名对应的数据不存在且没有设置默认值,则会返回 undefined。因此,建议在调用该函数时,始终设置默认值。例如:

// 在脚本中获取一个名为 'foo' 的键值对应的数据
// 如果该数据不存在,则返回默认值 'default'
const fooData = GM_getValue('foo', 'default')

以上为 GM API 提供的内爆函数介绍,使用简单方便,可以帮助我们更好地管理用户脚本的本地数据。