如何让Greasemonkey/Tampermonkey脚本在Firefox内置PDF查看器生效?
解决Firefox内置PDF查看器中Greasemonkey/Tampermonkey脚本失效的问题
这个问题很典型——Firefox的内置PDF查看器是基于PDF.js的独立扩展环境,普通用户脚本默认不会被注入到这个特殊的上下文里,所以你的双击翻译脚本在PDF页面上无法触发。下面是具体的修复方案:
1. 更新脚本的元数据,让它能注入到PDF查看器页面
首先需要修改脚本的@match规则,确保脚本能匹配到Firefox打开PDF时的两种场景:直接访问PDF文件的URL,以及内置查看器的viewer.html页面(这是PDF.js的核心界面)。
修改后的完整脚本如下:
// ==UserScript== // @name translator // @version 1.1 // @match *://*/*.pdf // @match moz-extension://*/viewer.html* // @grant none // ==/UserScript== document.addEventListener('dblclick', handleDblClick, true); function handleDblClick(e) { // 仅在PDF文本区域触发,避免误操作 if (!e.target.closest('.textLayer')) return; const selectedText = window.getSelection().toString().trim(); if (!selectedText) return; // 对文本编码,避免特殊字符导致URL错误 const encodedText = encodeURIComponent(selectedText); window.open(`https://translate.google.ru/?hl=ru&text=${encodedText}`); }
2. 关键修改点说明
@match规则:*://*/*.pdf:匹配所有直接通过HTTP/HTTPS打开的PDF文件moz-extension://*/viewer.html*:匹配Firefox内置PDF查看器的核心页面(每个用户的扩展UUID不同,用*通配)
- 文本区域过滤:通过
e.target.closest('.textLayer')判断点击是否在PDF的文本层,避免点击PDF的工具栏、空白区域时触发脚本 - URL编码:用
encodeURIComponent()处理选中的文本,确保空格、特殊字符不会破坏翻译链接的格式
3. 确保用户脚本管理器允许访问扩展URL
如果你用的是Tampermonkey,需要在插件设置里开启以下权限:
- 允许访问文件URL
- 允许访问
moz-extension://开头的URL
Greasemonkey默认已经支持这类访问,但如果还是有问题,可以检查它的权限设置。
测试验证
打开你提供的测试PDF,双击选中任意单词,应该能正常打开谷歌翻译页面并加载对应的文本了。
内容的提问来源于stack exchange,提问作者escudero380




