油猴脚本开发中文文档合集第一节Userscript Header

发表于 2019-12-13 08:21:23

马上注册，结交更多网友，浏览器插件/脚本不再愁！

您需要登录才可以下载或查看，没有帐号？注册会员

x

本帖最后由疯子先生于 2019-12-13 08:54 编辑

文档介绍如何使用Tampermonkey API，以及与Geasemonkey的不同之处。此部分为Userscript Header部分

USERSCRIPT HEADER

发表于 2019-12-13 08:52:59

@resource

预加载可以通过脚本通过GM_getResourceURL和GM_getResourceText访问的资源。

// @resource icon1 http://www.tampermonkey.net/favicon.ico
// @resource icon2 /images/icon.png
// @resource html http://www.tampermonkey.net/index.html
// @resource xml http://www.tampermonkey.net/crx/tampermonkey.xml
// @resource SRIsecured1 http://www.tampermonkey.net/favicon.ico#md5=123434...
// @resource SRIsecured2 http://www.tampermonkey.net/favicon.ico#md5=123434...;sha256=234234...

复制代码

允许多个标记实例。

发表于 2019-12-13 08:47:24

@nocompat

目前，TM试图通过查找@match标记来检测脚本是否是在Google Chrome/Chrome的知识中编写的，但并不是每个脚本都使用它。这就是为什么TM支持这个标签来禁用运行为Firefox/Greasemonkey编写的脚本所需的所有优化。要保持此标记可扩展，可以添加可由脚本处理的浏览器名称。

// @nocompat Chrome

复制代码

发表于 2019-12-13 08:46:56

@unwrap

这个标签被忽略，因为Google Chrome/Chromium不需要它。

发表于 2019-12-13 08:46:28

@noframes

此标记使脚本在主页面上运行，但不在iframe上运行。

发表于 2019-12-13 08:44:55

@grant

@grant用于白名单GM_ux函数、unsafeWindow对象和一些强大的窗口函数。如果没有给@grant标记，TM会猜测脚本需要什么。

// @grant GM_setValue
// @grant GM_getValue
// @grant GM_setClipboard
// @grant unsafeWindow
// @grant window.close
// @grant window.focus

复制代码

由于关闭和聚焦选项卡是一个强大的功能，因此还需要将其添加到@grant语句中。

如果@grant后跟“none”，沙盒将被禁用，脚本将直接在页面上下文中运行。在此模式下，没有GM_u*函数，但GM_uinfo属性将可用。

// @grant none

复制代码

发表于 2019-12-13 08:44:09

@run-at

定义脚本被注入的时刻。与其他脚本处理程序相反，@run at定义了脚本要运行的第一个可能时刻。这意味着，使用@require标记的脚本可能会在加载文档后执行，因为获取所需脚本花费了很长时间。无论如何，在给定的注入时刻之后发生的所有DOMNodeInserted和DOMContentLoaded事件都将被缓存，并在注入时传递给脚本。

// @run-at document-start

复制代码

脚本将尽快注入。

// @run-at document-body

复制代码

如果主体元素存在，脚本将被注入。

// @run-at document-end

复制代码

将在发送DOMContentLoaded事件时或之后注入脚本。

// @run-at document-idle

复制代码

将在调度DOMContentLoaded事件后注入脚本。如果没有给出@run at标记，这是默认值。

// @run-at context-menu

复制代码

如果在浏览器上下文菜单中单击脚本（仅限基于桌面Chrome的浏览器），脚本将被注入。

注意：如果使用此值，则所有@include和@exclude语句都将被忽略，但将来可能会发生变化。

发表于 2019-12-13 08:40:28

@connect

This tag defines the domains (no top-level domains) including subdomains which are allowed to be retrieved by GM_xmlhttpRequest

// @connect <value>

复制代码

<value>可以有以下值：

像tampermonkey.net这样的域（这也允许所有子域）

子域，即safari.tanpermonkey.net
self列出脚本当前运行的域
localhost访问localhost
1.2.3.4连接到IP地址
*

如果无法声明用户脚本可能连接到的所有域，则最好执行以下操作：

声明所有已知或至少所有可能由脚本连接的公共域。这样，大多数用户都可以避免确认对话框。

另外在脚本中添加“@connect*”。通过这样做，Tampermonkey仍然会询问用户是否允许下一个连接到未提及的域，但也会提供一个“总是允许所有域”按钮。如果用户单击此按钮，则将自动允许所有未来的请求。

用户还可以通过在“脚本设置”选项卡的用户域白名单中添加“*”来白名单所有请求。

笔记：

同时，将检查初始和最终的URL！

为了向后兼容Scriptish@domain标记也会被解释。

允许多个标记实例。

发表于 2019-12-13 08:38:02

@require

指向在脚本本身开始运行之前加载并执行的JavaScript文件。

注意：通过@require加载的脚本及其“use strict”语句可能会影响userscript的strict模式！

// @require https://code.jquery.com/jquery-2.1.4.min.js
// @require https://code.jquery.com/jquery-2.1.3.min.js#sha256=23456...
// @require https://code.jquery.com/jquery-2.1.2.min.js#md5=34567...,sha256=6789...

复制代码

发表于 2019-12-13 08:37:38

@exclude

排除url，即使它们包含在@include或@match中。

允许多个标记实例。

油猴脚本开发中文文档合集第一节Userscript Header

马上注册，结交更多网友，浏览器插件/脚本不再愁！

频道

关于

友链

免责声明