快速上手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) } })`