油猴搅本开发(基础注解

油猴搅本开发(基础注解

@match

在Tampermonkey中,@match指令用于指定您的脚本应该运行的网页。@match的值应该是一个URL模式,与您希望您的脚本运行的页面匹配。以下是URL模式的各个部分,您需要设置:

// @match ://

protocol – 这是URL的第一部分,在冒号之前。它指定页面使用的协议,如http或https。*匹配所有协议。domain – 这是URL的第二部分,在协议和两个斜杠之后。它指定网站的域名,如tmnk.com。您可以使用通配符 *.tmnk.net 来匹配 tmnk.net 和其任何子域名,如 www.tmnk.net。path – 这是URL的一部分,位于域名之后,可能包括其他子目录或文件名。您可以使用通配符 * 来匹配路径的任何部分。

请查看此文档以获取有关匹配模式的更多信息。注意:尚不支持 声明,协议部分还接受 http*://。

允许多个标签实例。

更多示例:

// @match *://*/*

// @match https://*/*

// @match http://*/foo*

// @match https://*.tampermonkey.net/foo*bar

@exclude

即使包含在@include或@match中,也要排除URL。

允许多个标签实例。

@run-at

定义脚本注入的时机。与其他脚本处理程序相反,@run-at定义了脚本希望运行的最早时刻。这意味着,如果一个使用了@require标签的脚本在文档加载完成后才执行,那是因为获取所需脚本花费了很长时间。无论如何,所有在给定注入时刻之后发生的 DOMNodeInserted 和 DOMContentLoaded 事件都会被缓存,并在脚本注入时交付给脚本。

// @run-at document-start

脚本将尽快被注入。

// @run-at document-body

如果body元素存在,脚本将被注入。

GM_notification(details, ondone), GM_notification(text, title, image, onclick)

GM_notification允许用户在屏幕上显示通知,使用提供的消息和其他可选参数。

该函数接受多个参数,可以是一个details对象或多个直接参数。

details对象可以具有以下属性,其中某些属性也可以作为直接参数使用。

可用选项包括:

text:要在通知中显示的消息的字符串。title:通知的标题。image:要在通知中显示的图像的URL。highlight:一个布尔值标志,指示是否突出显示发送通知的选项卡(如果没有设置text,则为必需)。silent:一个布尔值标志,指示是否不播放声音。timeout:通知自动关闭的时间(以毫秒为单位)。onclick:当用户点击通知时将调用的回调函数。ondone:当通知关闭(无论是由超时还是点击触发)或选项卡突出显示时将调用的回调函数。

该函数没有返回值。

以下是该函数的使用示例:

GM_notification({

text: "This is the notification message.",

title: "Notification Title",

onclick: () => alert('I was clicked!')

});

GM_openInTab(url, options), GM_openInTab(url, loadInBackground)

GM_openInTab允许用户脚本在浏览器中打开一个新标签页并导航到指定的URL。

该函数接受两个参数:

一个名为"url"的字符串,包含要在新标签页中打开的页面的URL。

一个可选的options对象,用于自定义新标签页的行为。可用选项包括:

active:一个布尔值,指示新标签页是否应处于活动状态(选中状态)。默认值为false。insert:一个整数,指示新标签页应插入到标签栏中的位置。默认值为false,表示新标签页将添加到标签栏的末尾。setParent:一个布尔值,指示新标签页是否应被视为当前标签页的子标签页。默认值为false。incognito:一个布尔值,在隐身模式/私密模式窗口中打开标签页。loadInBackground:一个布尔值,与active的含义相反,添加此选项是为了实现Greasemonkey 3.x的兼容性。

该函数返回一个具有close函数、onclose监听器和一个名为closed的标志的对象。

// @run-at document-end

相关推荐