快速上手Tampermonkey（篡改猴aka油猴脚本）

原創

2023-12-12 21:40

首先怎么安装就不详细说了，去火狐、chrome或edge的应用商店搜索Tampermonkey安装即可。官网在此：https://www.tampermonkey.net

注解配置项说明

配置说明
配置项 (a-z ↑)	说明
@antifeature	隐私与安全声明，如内嵌广告、收集用户数据、挖矿
@author	作者名称
@connect	配置哪些域可以被GM_xmlhttpRequest这个API访问
@copyright	版权说明
@description	功能描述
@downloadURL
@exclude	被通配符匹配上的网站不运行脚本, 即使@match和@include已匹配，允许多行声明
@grant	用来申请GM_函数和unsafeWindow权限。默认情况下，脚本是运行在油猴创建的沙盒环境下，沙盒环境无法获取前端页面的上下文。如果声明// @grant none，油猴就会将脚本直接放在前端的上下文中执行，但是这样的话就无法使用GM_等函数，一般写脚本的时候是使用unsafeWindow与前端交互，而不使用//@grant none，避免恶意网页检测到并利用GM_*函数
@homepage, @homepageURL, @website, @source	作者主页，未填写则取@namespace
@icon, @iconURL, @defaulticon	脚本图标，可以是图片URL或base64字符串，低分辨率
@icon64, @icon64URL	脚本图标，64x64
@include	和@match类似，允许多行声明
@match	置顶可以运行脚本的网站，可以使用通配符或正则来匹配网址，允许多行声明
@name	脚本名称
@namespace	命名空间，区分不同作者，一般都是写作者的个人网址
@noframes	禁止脚本在iframe中运行，可避免被一个页面嵌套的多个iframe执行多次
@require	脚本依赖的js地址，有多个依赖可以声明多次（若依赖的js有"use strict"可能会影响当前脚本的严格模式）
@resource	定义一些需要预加载的资源文件，这些资源可以在脚本中通过GM_getResourceURL，GM_getResourceText访问，允许多行声明
@run-at	注入脚本的时机，可选：context-menu（默认）、document-start、document-body、document-end、document-idle
@sandbox	脚本是否需要运行在沙箱中
@supportURL	定义帮助页面的地址，方便用户反馈信息和咨询
@updateURL	脚本的更新地址，必须要和 @version 搭配
@unwrap	单行的方式插入脚本（具体作用未知）
@version	版本号，用于脚本的更新
@webRequest	配置GM_webRequest这个API的默认rules参数，可在脚本loaded之前生效

API
名称	说明
none	不需要任何API
GM_log	打印日志
GM_setValue	新增/编辑缓存
GM_getValue	获取缓存
GM_deleteValue	删除缓存
GM_addValueChangeListener	监听缓存。 `// 添加一个监听器 const listener_id = GM_addValueChangeListener('hello', function(name, old_value, new_value, remote){ if(hello == false){ //具体的调用方法 //.... } })`
GM_removeValueChangeListener	移除缓存监听 `GM_removeValueChangeListener(listener_id)`
GM_openInTab	`//active:true，新标签页获取页面焦点 //setParent :true:新标签页面关闭后，焦点重新回到源页面 GM_openInTab("https://www.baidu.com",{ active: true, setParent :true})`
GM_xmlhttpRequest	发送跨域请求第一次跨域请求时，会弹出请求对话框，需要选中允许，才能正常进行跨域请求 `GM_xmlhttpRequest({ url: 'http://www.httpbin.org/post', method: 'POST', headers: { 'content-type': 'application/json' }, data: '', onerror: function (res) { console.log(res) }, onload: function (res) { console.log(res) } })`