Violentmonkey脚本中加载Google字体的正确方法

在使用Violentmonkey脚本管理器时，开发者经常需要为网页添加自定义字体样式。Google Fonts作为流行的网络字体服务，是许多开发者的首选。然而，直接通过修改DOM的方式引入Google字体可能会遇到内容安全策略(CSP)的限制。

常见错误做法

许多开发者会尝试通过直接操作DOM的innerHTML属性来添加字体链接，例如：

document.head.innerHTML += `
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  <link href="https://fonts.googleapis.com/css2?family=Fira+Code&display=swap" rel="stylesheet">
`;

这种做法会导致浏览器控制台报错："Content-Security-Policy: The page's settings blocked the loading of a resource"，因为现代网页通常设置了严格的内容安全策略，禁止通过脚本动态添加外部资源。

正确解决方案

Violentmonkey提供了专门的API来解决这类问题。推荐使用GM_addElement方法来安全地添加外部资源：

// 必须在元数据中声明grant权限
// @grant GM_addElement

// 添加字体预连接
GM_addElement('link', {
  rel: 'preconnect',
  href: 'https://fonts.googleapis.com'
});

// 添加跨域预连接
GM_addElement('link', {
  rel: 'preconnect',
  href: 'https://fonts.gstatic.com',
  crossorigin: true
});

// 添加字体样式表
GM_addElement('link', {
  rel: 'stylesheet',
  href: 'https://fonts.googleapis.com/css2?family=Fira+Code&display=swap'
});

技术原理

GM_addElement是Violentmonkey提供的专用API，它通过扩展的安全通道来添加DOM元素，能够绕过页面的内容安全策略限制。这种方法比直接操作innerHTML或createElement更可靠，因为：

1. 它使用Violentmonkey的特权上下文执行，不受页面CSP限制
2. 提供了更简洁的API来创建和插入元素
3. 自动处理了跨域等特殊属性

最佳实践建议

1. 始终在脚本元数据中声明所需的grant权限
2. 对于字体资源，先建立预连接(preconnect)以提升加载性能
3. 明确设置跨域属性(crossorigin)以确保资源正确加载
4. 考虑使用字体显示策略(display=swap)来优化页面渲染体验
5. 对于频繁使用的脚本，可以将字体缓存到本地存储中

通过遵循这些实践，开发者可以确保在Violentmonkey脚本中可靠地加载和使用Google字体，同时保持页面的性能和安全性。