GM_函数完全指南:解锁Tampermonkey高级功能的25个API
Tampermonkey作为全球最受欢迎的用户脚本管理器,拥有超过1000万用户,其强大的GM_函数API系统是用户脚本开发的核心。GM_函数提供了跨浏览器兼容的高级功能,让开发者能够轻松实现数据存储、网络请求、页面操作等复杂任务。
🎯 什么是GM_函数?
GM_函数是Tampermonkey提供的一组特殊API,专门用于增强用户脚本的功能。这些函数涵盖了从简单的数据存储到复杂的网络请求等各个方面。通过GM_函数,用户脚本可以突破浏览器限制,实现更强大的功能。
🔧 25个必备GM_函数详解
数据存储与配置函数
GM_setValue - 保存用户配置数据 GM_getValue - 读取存储的数据 GM_deleteValue - 删除指定数据 GM_listValues - 列出所有存储的键名
网络请求与通信函数
GM_xmlhttpRequest - 跨域网络请求 GM_notification - 桌面通知功能 GM_openInTab - 在新标签页打开链接
页面操作与样式函数
GM_addStyle - 动态添加CSS样式 GM_registerMenuCommand - 注册自定义菜单项 GM_setClipboard - 设置剪贴板内容
资源管理与信息函数
GM_getResourceText - 获取外部资源文本 GM_getResourceURL - 获取资源URL GM_info - 获取脚本信息
多标签页与脚本管理函数
GM_getTab - 获取当前标签页信息 GM_getTabs - 获取所有标签页信息 GM_saveTab - 保存标签页状态 GM_installScript - 安装其他用户脚本
事件监听与日志函数
GM_addValueChangeListener - 监听数据变化 GM_removeValueChangeListener - 移除监听器 GM_log - 输出调试日志
高级功能与兼容性函数
GM_runNative - 运行原生代码 GM_execUnsafe - 执行不安全代码 GM_EMU - 兼容性模拟函数
📝 实际应用场景
一键配置保存
使用GM_setValue和GM_getValue,用户可以保存和恢复脚本的个性化配置,实现"一次设置,永久使用"的便捷体验。
跨域数据抓取
GM_xmlhttpRequest允许脚本从不同域名的网站获取数据,为数据分析、内容聚合等应用提供了可能。
页面美化与增强
通过GM_addStyle和GM_registerMenuCommand,脚本可以为网站添加自定义样式和功能菜单。
🚀 快速上手指南
函数声明与使用
在用户脚本的元数据中,必须通过@grant指令声明需要使用的GM_函数。例如:
// ==UserScript==
// @grant GM_setValue
// @grant GM_getValue
// ==/UserScript==
兼容性处理
Tampermonkey通过src/environment.js中的GM_EMU函数确保GM_函数在不同浏览器环境中的一致表现。
💡 进阶技巧与最佳实践
错误处理机制
在使用GM_xmlhttpRequest等网络相关函数时,务必添加错误处理逻辑,确保脚本的稳定性。
性能优化建议
合理使用数据存储函数,避免频繁的读写操作影响页面性能。
🛠️ 开发工具与资源
- 官方文档:docs/official.md
- 核心实现:src/environment.js
- 网络请求模块:src/system/tamperfireDB.tamper.js
掌握这25个GM_函数,你将能够开发出功能强大、用户体验优秀的用户脚本,充分发挥Tampermonkey的潜力,为日常网页浏览和工作效率带来革命性的提升!
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考





