我可以允许我的扩展的域匹配是用户可配置的吗?我想让我的用户选择扩展程序的运行时间。
问问题
856 次
1 回答
13
要为内容脚本实现可定制的“匹配模式”,需要由后台页面使用该方法执行内容脚本(在使用事件侦听chrome.tabs.executeScript
器检测到页面加载之后)。chrome.tabs.onUpdated
因为匹配模式检查没有在任何 API 中公开,所以您必须自己创建方法。它在 中实现url_pattern.cc
,并且规范在匹配模式中可用。
下面是一个解析器的例子:
/**
* @param String input A match pattern
* @returns null if input is invalid
* @returns String to be passed to the RegExp constructor */
function parse_match_pattern(input) {
if (typeof input !== 'string') return null;
var match_pattern = '(?:^'
, regEscape = function(s) {return s.replace(/[[^$.|?*+(){}\\]/g, '\\$&');}
, result = /^(\*|https?|file|ftp|chrome-extension):\/\//.exec(input);
// Parse scheme
if (!result) return null;
input = input.substr(result[0].length);
match_pattern += result[1] === '*' ? 'https?://' : result[1] + '://';
// Parse host if scheme is not `file`
if (result[1] !== 'file') {
if (!(result = /^(?:\*|(\*\.)?([^\/*]+))(?=\/)/.exec(input))) return null;
input = input.substr(result[0].length);
if (result[0] === '*') { // host is '*'
match_pattern += '[^/]+';
} else {
if (result[1]) { // Subdomain wildcard exists
match_pattern += '(?:[^/]+\\.)?';
}
// Append host (escape special regex characters)
match_pattern += regEscape(result[2]);
}
}
// Add remainder (path)
match_pattern += input.split('*').map(regEscape).join('.*');
match_pattern += '$)';
return match_pattern;
}
示例:在匹配模式的页面上运行内容脚本
在下面的示例中,数组是硬编码的。localStorage
在实践中,您可以使用or将匹配模式存储在数组中chrome.storage
。
// Example: Parse a list of match patterns:
var patterns = ['*://*/*', '*exampleofinvalid*', 'file://*'];
// Parse list and filter(exclude) invalid match patterns
var parsed = patterns.map(parse_match_pattern)
.filter(function(pattern){return pattern !== null});
// Create pattern for validation:
var pattern = new RegExp(parsed.join('|'));
// Example of filtering:
chrome.tabs.onUpdated.addListener(function(tabId, changeInfo, tab) {
if (changeInfo.status === 'complete') {
var url = tab.url.split('#')[0]; // Exclude URL fragments
if (pattern.test(url)) {
chrome.tabs.executeScript(tabId, {
file: 'contentscript.js'
// or: code: '<JavaScript code here>'
// Other valid options: allFrames, runAt
});
}
}
});
要使其正常工作,您需要在清单文件中请求以下权限:
"tabs"
- 启用必要的tabs
API。"<all_urls>"
- 能够用于chrome.tabs.executeScript
在特定页面中执行内容脚本。
固定的权限列表
如果匹配模式的集合是固定的(即用户不能定义新的,只能切换模式),"<all_urls>"
可以用这组权限替换。您甚至可以使用可选权限来减少请求权限的初始数量(在文档中有chrome.permissions
明确说明)。
于 2012-09-15T11:07:57.507 回答