2023年11月27日发(作者:)

Tampermonkey中⽂⽂档

⽤户脚本标题

@name

脚本的名称。

@namespace

脚本的。

@version

脚本版本。这⽤于更新检查,以防脚本未从安装,或者 TM 检索脚本时出现问题。

@author

脚本作者。

@description

⼀个简短的重要描述。

@homepage@homepageURL@website@source

在选项页中使⽤的作者主页从脚本名称链接到给定页⾯。请注意,如果@namespace标签以""开头,其内容也将⽤于此。

@icon@iconURL@defaulticon

低分辨率下的脚本图标。

@icon64@icon64URL

定义当检测到更新时将从其中下载脚本的URL。如果使⽤none值,则不会执⾏更新检查。

@supportURL

定义⽤户可以报告问题和获得个⼈⽀持的 URL。

@include

该脚本应运⾏的页⾯。允许多个标记实例。

1// @resource icon1 /

2// @resource icon2 /images/

3// @resource html /

4// @resource xml /crx/

5// @resource SRIsecured1 /#

6// @resource SRIsecured2 /#;

有关如何确保完整性的详细信息,请查看部分。允许多个标记实例。

@connect

// @run-at document-body

如果正⽂元素存在,将注⼊脚本。

代码:

// @run-at document-end

在调度 DOM内容加载事件时或之后,将注⼊脚本。

此标签被忽略,因为,这是不需要在⾕歌Chrome/Chromium。

@nocompat

⽬前,TM试图通过查找@match标记来检测是否使⽤了⾕歌Chrome/Chromium编写的脚本,但并不是每个脚本都使⽤它。这就是为什么

TM⽀持这个标签来禁⽤所有可能需要的优化来运⾏为Firefox/Greasemonkey编写的脚本。要保持此标记的可扩展性,可以添加可由脚本

处理的浏览器名称。

代码:

将更改侦听器添加到存储中并返回侦听器ID。'name'是观察到的变量的名称。回调函数的'remote'参数显⽰这个值是在另⼀个选项卡的实例

中修改的(true)还是在这个脚本实例中修改的(false)。因此,不同浏览器选项卡的脚本可以使⽤此功能进⾏通信。

GM_removeValueChangeListener(listener_id)

否则只会追加新选项卡。loadInBackground和active有相反的含义,添加它是为了实现Greasemonkey 3.x兼容性。如果未提供active或

loadInBackground,则选项卡将不会聚焦。此函数返回⼀个对象,该对象具有函数close、侦听器onclosed和⼀个称为closed的标记。

GM_xmlhttpRequest(details)

制作⼀个xmlHttpRequest。

detail具有以下属性:

saveAs 布尔值,显⽰⼀个另存为对话框

onerror 如果此下载以错误结束,则执⾏回调

onload 下载完成后要执⾏的回调

onprogress 如果此下载取得⼀些进展,则执⾏回调

超时回调 如果此下载由于超时⽽失败,则执⾏回调

GM_setClipboard(data, info)

将数据复制到剪贴板。 参数“ info”可以是“ {type:'text',mimetype:'text / plain'}”之类的对象,也可以是表⽰类型的字符串(“

text”或“ html”)。

GM_info

获取有关脚本和TM的⼀些信息。 该对象可能如下所⽰:

<>

Tampermonkey⽀持这种存储元数据的⽅式。TM尝试⾃动检测脚本是否需要启⽤此兼容性选项。