android monkey脚本软件 tampermonkey脚本网站

目录
@name
@name 脚本的名字
@namespace
@namespace 脚本的命名空间
@version
脚本的版本，用于检查更新。
@author
脚本的作者
@description
简短重要的描述
@homepage, @homepageURL, @website and @source
在“选项”页上用于从脚本名链接到给定页的作者主页。请注意，如果@namespace标记以“http://”开头，则其内容也将用于此操作。
@icon, @iconURL and @defaulticon
低分率的脚本会在脚本管理列表上显示
@icon64 and @icon64URL
脚本icon 64*64 如果给了这个标签，但给了图标，则图标图像将在选项页的某些位置缩放
@updateURL
更新脚本的地址，注意：只有存在@version标签才会去更新
@downloadURL
定义检测到更新时将从中下载脚本的URL。如果值为none，则不会执行更新检查。
@supportURL
定义使用者报告issues和个人支持的地址
@include
脚本应该运行的页面， 可以使用正则匹配。 允许多个标签
 请注意@include不支持url hash参数，可以访问这里获取更多的信息点击获取更多信息// @include http://www.tampermonkey.net/*
// @include http://*
// @include https://*
// @include *@match
和@include标签差不多的意思， 你可以点击这里获取更多信息
 注意： 尚不支持“”语句，scheme部分也接受“http*：//”。
 允许多个标记实例。@exclude
排除URL，即使它们包含在@include或@match中 。 允许多个标签
@require
指向一个脚本文件，会在本脚本运行前加载并执行
 注意：通过 @require 加载的脚本及其“use strict”语句可能会影响用户脚本的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...有关如何确保完整性的详细信息，请查看子资源完整性部分。允许多个标记实例。
@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...@connect
此标记定义域（没有顶级域），包括允许由 GM_xmlhttpRequest 检索的子域
 // @connect <value>
 可以是以下几个值• 域可以是: tampermokey.net (可以允许子域名)
• 子域名如: safari.tampermokey.net

• 
self :列出脚本当前运行的域
• 
localhost 有权限访问localhost
• 
1.2.3.4 链接到IP地址
• *
@run-at
定义脚本被注入的时间，与其他脚本处理相反，@run-at 定义了脚本要运行的第一可能时间。
这意味着，使用@require标记的脚本可能会在文档已加载后执行，因为获取所需脚本花费了很长时间。无论如何，在给定的注入时刻之后发生的所有domnodeinserted和domcontentloaded事件都将被缓存，并在注入时传递给脚本。
// @run-at document-start   // 脚本会被尽可能快地注入
// @run-at document-body    // 当body元素存在是被注入
// @run-at document-end     // 当DOMContentLoaded事件被触发时或者之后注入
// @run-at document-idle    // 当DOMContentLoaded事件被触发后被注入 如果没有@run-at标签也是在此时注入
// @run-at context-menu     // 当点击浏览器上下文菜单时被注入（仅仅是桌面Chrome-based浏览器）
// 注意：如果使用了context-menu @include和@exclude的变量都将被忽略，但是未来可能会改变@grant
@grant被用于设置GM_*函数的白名单， GM_*function 是一些unsafeWindow对象和一些有影响的window函数，如果没有@grant标签，TM会猜测脚本需要什么
// @grant GM_setValue
// @grant GM_getValue
// @grant GM_setClipboard
// @grant unsafeWindow
// @grant window.close
// @grant window.focus@noframes
这个标签表明脚本在主页面上运行，而不是在iframes里
@unwrap
这个标签是被忽略的，因为他在谷歌浏览器里不需要
@nocompat
目前，tm试图通过查找@match标记来检测脚本是否是在google chrome/chromium的知识中编写的，但并不是每个脚本都使用它。这就是为什么tm支持这个标签来禁用运行为firefox/greasemonkey编写的脚本所需的所有优化。要保持此标记可扩展，可以添加可由脚本处理的浏览器名称。
应用程序接口（高级API）
unsafeWindow
unsafeWindow 对象提供权限访问页面的js函数和变量
Subresource Integrity
可以使用@resource和@require标记的url的散列组件来实现此目的。
// @resource SRIsecured1 http://www.tampermonkey.net/favicon1.ico#md5=ad34bb...
// @resource SRIsecured2 http://www.tampermonkey.net/favicon2.ico#md5=ac3434...,sha256=23fd34...
// @require https://code.jquery.com/jquery-2.1.1.min.js#md5=45eef...
// @require https://code.jquery.com/jquery-2.1.2.min.js#md5=ac56d...,sha256=6e789...TM本机支持MD5哈希作为回退，所有其他（SHA-1、SHA-256、SHA-384和SHA-512）都依赖于window.crypto。如果给定了多个散列（用逗号或分号分隔），则TM将使用当前支持的最后一个散列。如果外部资源的内容与所选哈希不匹配，则资源不会传递到用户脚本。所有散列都需要以十六进制或base64格式编码。
GM_addStyle(css)
给document添加样式，并且返回注入的节点
GM_deleteValue(name)
删除‘name’ 从storage里
GM_listValues()
列出storage中的所有name
GM_addValueChangeListener(name, function(name, old_value, new_value, remote) {})
在storage里添加一个改变事件的监听，并返回监听id
‘name’是被观察的变量
回调函数的‘remote’变量是显示此值是从另一个选项卡的实例修改的（true）还是在此脚本实例中修改的（false）。
因此，不同浏览器选项卡的脚本可以使用此功能相互通信。
可以使用此API实现不同浏览器Tab的相互通讯
GM_removeValueChangeListener(listener_id)
通过监听器的id移除一个监听改变的事件
GM_setValue(name, value)
设置‘name‘ 的值到storage中
GM_getValue(name, defaultValue)
从storage中获取‘name’的值
GM_log(message)
在控制台打印日志
GM_getResourceText(name)
获取在脚本顶部预定的@resource标签的内容
GM_getResourceURL(name)
获取在脚本顶部定义的@resource标签的base64 encodeURI
GM_registerMenuCommand(name, fn, accessKey)
注册一个能在页面上能够显示TM菜单命令，当这个脚本执行是，并且返回菜单命令id
意思就是可以注册一个直接显示TM的菜单的ming
GM_unregisterMenuCommand(menuCmdId)
取消注册一个菜单命令根据菜单命令ID(通过GM_registerMenuCommand 提供的)
GM_openInTab(url, options), GM_openInTab(url, loadInBackground)
使用参数url打开一个新的tab，options可以是以下值
• active 决定新的tab是否被聚焦，聚焦的意思是直接显示
• insert 插入一个新的tab在当前的tab后面
• setParent 在tab关闭后重新聚焦当前tab
另外，新的选项卡将被添加。loadinbackground具有与active相反的含义，并被添加以实现Greasemonkey 3.x兼容性。如果未指定“活动”或“加载后台”，则选项卡将不会聚焦。此函数返回一个具有函数close、侦听器onclosed和一个名为closed的标志的对象。
GM_xmlhttpRequest(details)
创建一个xmlHttpRequest.
 参数details 的属性有:• method 可以是 GET, HEAD, POST其中一种
• url 请求的url
• headers 如： user-agent, referer, … (一些特殊的 headers 不被支持在Safari and Android 浏览器里)
• data 一些字符串有post请求发送过去
• binary 说过binary 模式，类型发送数据
• timeout 超时时间
• context 被添加到response对象上的对象
• responseType 可以是 arraybuffer, blob, json
• overrideMimeType 请求的 MIME type
• anonymous 在请求中不需要发送cookies，详细请看fetch 注释
• fetch (beta) 使用一个fetch来代替xhr请求， 在chrome中，这会导致xhr.abort、details.timeout和xhr.onprogress不工作，并使xhr.onreadystatechange仅接收readystate 4事件
• username 授权的用户名
• password 授权的用户密码
• onabort 请求中断时执行的回调函数
• onerror 请求以错误结束时需要执行的回调函数
• onloadstart 请求开始加载时执行的回调函数
• onprogress 请求状态变化时执行的回调函数
• onreadystatechange 请求的准备状态改变是执行的回调函数
• ontimeout 超时后执行的回调函数
• onload 当请求被返回时执行的回调函数 ，他的几个参数如下： 
  
• finalUrl - the final URL after all redirects from where the data was loaded
• readyState - the ready state
• status - the request status
• statusText - the request status text
• responseHeaders - the request response headers
• response - the response data as object if details.responseType was set
• responseXML - the response data as XML document
• responseText - the response data as plain string
返回的对象包含以下属性：
• abort - 取消请求的函数
 注意: 属性synchronous 不支持Important: 如果你想使用这个方法请移步@connectb标签 查看更多信息
GM_download(details), GM_download(url, name)
使用下载资源到本地磁盘
details的属性：
• url - 资源的url
• name - 文件名，出于安全原因，文件的扩展名必须在TM 参数页面的的白名单里
• headers - 如GM_xmlhttpRequest 一样设置请求头部
• saveAs - boolean 值,显示一个保存的弹窗
• onerror 下载以失败结束执行的回调函数
• onload 现在完成后执行的回调函数
• onprogress 下载过程中变化的回调函数
• ontimeout 下载超时执行的回调函数
 现在文件中 onerror 的参数如下：• error - 错误原因 
  
• not_enabled - 用户未启用下载功能
• not_whitelisted - 下载的文件类型不在白名单里
• not_permitted - 用户开启了下载权限，但没downloads权限
• not_supported - 下载属性不支持，由于浏览器或者版本原因
• not_succeeded - 下载没有开始或者失败了。 details可以提供更多的信息
• details - 错误的详细情况
返回一个对象包含以下属性
• abort - 取消下载的函数
 根据下载模式，gm_u info提供一个名为download mode的属性，该属性设置为以下值之一：native、disabled或browser。GM_getTab(callback)
获取一个持久对象，只要该选项卡处于打开状态.
GM_saveTab(tab)
保存tab对象为了重新打开，在页面关闭后
GM_getTabs(callback)
获取所有tab对象作为散列与其他脚本实例通信。
GM_notification(details, ondone), GM_notification(text, title, image, onclick)
显示一个H5的桌面通知，或者高亮当前tab
 details 的属性：• text - 通知的问题 如果高亮就 就不需要
• title - 通知的标题
• image - 图片
• highlight - 一个boolean标志，是否高亮tab
• silent - 一个boolean 是否播放音乐
• timeout - 通知显示的时间 0表示 一直显示
• ondone - 通知被关闭时 无论是被点击还是超时 执行的函数
• onclick - 点击通知触发的函数
所有参数的作用与其对应的详细信息属性挂件完全相同。
GM_setClipboard(data, info)
复制数据到粘贴板，参数info可以是对象如{type: ‘text’, mimetype: ‘text/plain’}，或者是一个字符串 text， html
GM_info
获取一些脚本和TM的信息，数据结构如下
<><![CDATA[your_text_here]]></>
tampermonkey支持这种存储元数据的方式。TM尝试自动检测脚本是否需要启用此兼容性选项。