浏览器插件 - Chrome 对 UserScript 的声明头(metadata)兼容性一览

时间:2022-09-17 08:18:01

1.这里的UserScript指的是,油猴插件或者Tampermonkey插件等支持的格式如下例子:

// ==UserScript==
// @name
// @namespace http://AsionTang.CN
// @version 0.1
// @description
// @match <$URL$>
// @copyright 2013+, AsionTang
// @grant none
// ==/UserScript==

而谷歌浏览器直接支持将此脚本安装为扩展。那么在编写此脚本时,出现的疑问是:谷歌浏览器对 UserScript 脚本的兼容性如何?

网搜答案没有简单得到答案,但是多亏开源的优势,直接阅读Chrome的源代码即可得到答案:

Chrome相关源码参考地址:Log of /trunk/src/chrome/browser/extensions/user_script_master.cc

当前为201855版本可见如下代码:

 static const base::StringPiece kUserScriptBegin("// ==UserScript==");
static const base::StringPiece kUserScriptEng("// ==/UserScript==");
static const base::StringPiece kNamespaceDeclaration("// @namespace");
static const base::StringPiece kNameDeclaration("// @name");
static const base::StringPiece kVersionDeclaration("// @version");
static const base::StringPiece kDescriptionDeclaration("// @description");
static const base::StringPiece kIncludeDeclaration("// @include");
static const base::StringPiece kExcludeDeclaration("// @exclude");
static const base::StringPiece kMatchDeclaration("// @match");
static const base::StringPiece kExcludeMatchDeclaration("// @exclude_match");
static const base::StringPiece kRunAtDeclaration("// @run-at");
static const base::StringPiece kRunAtDocumentStartValue("document-start");
static const base::StringPiece kRunAtDocumentEndValue("document-end");
static const base::StringPiece kRunAtDocumentIdleValue("document-idle");

而在源码最后还有一句:

// TODO(aa): Handle more types of metadata.

那么可见,当前尚有很多UserScript的声明头没有得到支持。