本节主要内容
介绍GM_get/setValue两个函数,油猴脚本的右键菜单能力.最后来一个菜单点击计次的脚本演示.
GM_get/setValue
GM_get/setValue
这两个函数可以使用KV键值对的方式存储数据,将数据保存在浏览器的储存中(tampermonkey插件是websql中),具体容量由扩展实现使用的存储介质所决定,不过一般来说肯定是够用的,不用太关注.
另外这个函数在Greasemonkey中是异步的,Tampermonkey是同步的,我们这里只针对Tampermonkey来讲解.注意:在两个不同的脚本中是无法共享数据的.
这个函数可以用来保存一些配置数据,像某些脚本的配置是写在脚本代码中的,更新脚本后配置又被还原,很不方便,这时就可以改造成get/setValue函数来储存下来.
使用方法
方法非常简单,我们一笔带过.注意两个函数都要使用 grant
去申请
// ==UserScript==
// @name New Userscript2
// @namespace http://tampermonkey.net/
// @version 0.1
// @description try to take over the world!
// @author You
// @match https://bbs.tampermonkey.net.cn/
// @grant GM_setValue
// @grant GM_getValue
// ==/UserScript==
GM_setValue("qqq",123);
console.log(GM_getValue("qqq"));
右键菜单
之前在说run-at的时候,有一个属性,不知道大家有没有注意,当时也没有详细讲解.除了 document-start/body/end/idle
这些控制脚本运行时间的外,还有一个 context-menu
的属性,用于右键点击菜单的时候执行脚本.如果你使用了 context-menu
属性,那么当你在所匹配的页面上右键时,菜单中就会以你脚本名显示出一菜单项,点击之后就是执行你的脚本代码.
(文档的最后还提了一下 #include
和 #exclude
,这两个属性和 #match
功能差不多,🤡实际上我也没用过这两,忽略好了)
// ==UserScript==
// @name 右键菜单和valude demo
// @namespace http://tampermonkey.net/
// @version 0.1
// @description try to take over the world!
// @author You
// @match https://bbs.tampermonkey.net.cn/*
// @run-at context-menu
// ==/UserScript==
alert("菜单被点击了");
自定义的菜单
除了使用 @run-at context-menu
生成菜单外,油猴还提供了两个函数GM_registerMenuCommand和GM_unregisterMenuCommand,分别用于注册菜单和删除菜单.更加灵活,但是不能显示在页面上,需要到油猴图标脚本那里去进行点击.
// ==UserScript==
// @name 右键菜单和valude demo
// @namespace http://tampermonkey.net/
// @version 0.1
// @description try to take over the world!
// @author You
// @match https://bbs.tampermonkey.net.cn/*
// @grant GM_registerMenuCommand
// @grant GM_unregisterMenuCommand
// ==/UserScript==
let id=GM_registerMenuCommand ("自定义的菜单", function(){
alert('菜单点击');
GM_unregisterMenuCommand(id);//删除菜单
}, "h");
// 第三个参数 accessKey 为快捷键,输入h即可触发。本脚本在点击一次之后会将菜单删除。
菜单点击计数器
利用油猴的存储功能来保存菜单被点击的次数,然后刷新次数(纯属使用而使用...想不到什么实战的例子...)
// ==UserScript==
// @name 右键菜单和valude demo
// @namespace http://tampermonkey.net/
// @version 0.1
// @description try to take over the world!
// @author You
// @match https://bbs.tampermonkey.net.cn/*
// @grant GM_setValue
// @grant GM_getValue
// @grant GM_registerMenuCommand
// @grant GM_unregisterMenuCommand
// ==/UserScript==
let id=GM_registerMenuCommand ("菜单第"+GM_getValue("click_num",0)+"点击",click, "h");
function click(){
GM_unregisterMenuCommand(id);
GM_setValue("click_num",GM_getValue("click_num",0)+1)
id=GM_registerMenuCommand ("菜单第"+GM_getValue("click_num",0)+"点击",click, "h");
}