Greasemonkey API

本页内容
上一节: Greasemonkey_元数据


GM_addStyle

描述

为页面添加样式一段CSS样式。

语法

function GM_addStyle (cssString)

参数

名称 类型 描述
cssString 字符串 字符串样式表

示例

GM.addStyle('#note{color: white; background: #3385ff!important;border-bottom: 1px solid #2d7');

GM_addElement

描述

增加一个页面元素，可以指定父节点，不指定父节点其节点为根元素。

语法

function GM_addElement(tagName, attributes)

或者 

function GM_addElement(parentNode,tagName, attributes)

参数

名称 类型 描述
tagName 字符串 元素名称
attributes 对象 属性名称/数值对
parentNode 对象 新建元素的父节点

示例

GM_addElement('script', {
  textContent: 'window.foo = "bar";'
});

GM_addElement('script', {
  src: 'https://xiaobai.wang/script.js',
  type: 'text/javascript'
});

GM_addElement(document.getElementsByTagName('div')[0], 'img', {
  src: 'https://xiaobai.wang/image.png'
});

GM_addElement(shadowDOM, 'style', {
  textContent: 'div { color: black; };'
});

GM_setValue

描述

通过指定的键值保存数据到浏览器本地存储中。

语法

function GM_setValue(name,value)

参数

名称 类型 描述
name 字符串 字符串键值
value 任意类型 可以是整数、字符串、布尔类型、对象等任意数据

示例

GM_setValue("foo", "bar");
GM_setValue("count", 100);
GM_setValue("active", true);
GM_setValue("data", {
  name: 'Andy',
  age: 18
});

GM_getValue

描述

从浏览器的本地存储获取一个值。

语法

function GM_getValue(name, defaultValue)

参数

名称 类型 描述
name 字符串 字符串键值
defaultValue 任意类型 可选项，如果键值从没有被设置过，返回默认值

返回值

如果键值被设置过，返回当初设置的数据类型。

示例

GM_setValue("foo", "bar");
GM_setValue("count", 100);
GM_setValue("active", true);
GM_setValue("data", {
  name: 'Andy',
  age: 18
});

var info = `foo = ${GM_getValue("foo")}
          count = ${GM_getValue("count")}
          active = ${GM_getValue("active")}
          data.name =  ${GM_getValue("data").name}`;                   
alert(info);

GM_listValues

描述

返回使用所以GM_setValue 设置的键值列表。

语法

function GM_listValues()

示例

GM_setValue("foo", "bar");
GM_setValue("count", 100);
GM_setValue("active", true);
GM_setValue("data", {
name: 'Andy',
age: 18
});
alert(GM_listValues());

GM_deleteValue

描述

删除通过GM_setValue 方法设置的键值。

语法

function GM_deleteValue(name)

参数

名称 类型 描述
name 字符串 字符串键值

示例

GM_deleteValue("foo");
let keys =  GM_listValues();
for (let key of keys) {
  GM_deleteValue(key);
}

GM_notification

描述

显示一条通知消息

语法

function GM_notification(details)

或者 

function GM_notification(text, title, image, onclick )

参数

名称 类型 描述
details 对象 一个包含text字段和ondone,onclick回调函数字段的对象
text 字符串 文本内容
title 字符串 参数为了兼容，手机端目前未实现
Image 对象 参数为了兼容，手机端目前未实现
onclick 回调函数 当用户点击了确定按钮的回调函数

示例

GM_notification("Hello!");

GM.notification({
  text: 'This is a message with callback',
  onclick: function() {
    alert("you click message ok button");
  },
  ondone: function() {
    alert("message bar closed");
  }
});

GM_notification("Hello","","",function() {
  alert("you click message ok button");
})

GM_setClipboard

描述

写入字符串数据到剪贴板

语法

function GM_setClipboard(data)

参数

名称 类型 描述
data 字符串 字符串内容

示例

GM_setClipboard('this is test data');

GM_registerMenuCommand

描述

注册一个菜单选项，菜单选项会显示在X浏览器的页面工具菜单中。

语法

function GM_registerMenuCommand(title,callback)

参数

名称 类型 描述
title 字符串 菜单名称
callback 回调函数 点击菜单项执行的回调函数

返回值

返回菜单项的命令ID, 注销菜单的时候会用到

示例

GM_registerMenuCommand("click me",function() {
	alert("You click menu item");
});

GM_unregisterMenuCommand

描述

注销之前注册的菜单项

语法

function GM_unregisterMenuCommand(commandId)

参数

名称 类型 描述
commandId 字符串 菜单项的命令id

示例

GM_unregisterMenuCommand(commandId);

GM_openInTab

描述

在新标签中打开一个页面

语法

function GM_openInTab(url,background)

参数

名称 类型 描述
url 字符串 新标签页面的网址
background 布尔类型 是否在后台打开标签,默认为false

示例

GM_openInTab("https://www.xiaobai.wang");
GM_openInTab("https://www.xiaobai.wang",true);

GM_download

描述

调用浏览器的默认下载器进行下载

语法

function GM_download(url,name)

或者 

function GM_download(detail)

参数

名称 类型 描述
url 字符串 要下载资源的网址
name 字符串 下载文件保存的名称
detail 对象 通过对象配置下载参数

detail 参数属性列表

  • url - 字符串类型，表示要下载的网址
  • name - 字符串类型，下载文件保存的名称
  • confirm - 布尔类型 ，是否弹出下载对话框，批量下载的时候设置此选项为false
  • tag - 字符串 ,下载文件打上标签，X浏览器的实现是相同的标签的资源保存在以标签命名的目录。

示例

GM_download("https://www.xbext.com/download/xbrowser-release.apk") 
//指定下载保存文件名称
GM_download("https://www.xbext.com/download/xbrowser-release.apk,"xbrowser.apk");
//批量下载，保存在默认下载目录，名字为tag的子目录
let urls = ["https://www.dundeecity.gov.uk/sites/default/files/publications/civic_renewal_forms.zip",
            "https://www.dundeecity.gov.uk/sites/default/files/publications/civic_renewal_forms.zip",
            "https://www.dundeecity.gov.uk/sites/default/files/publications/civic_renewal_forms.zip",
           ];
var i =0;
for(let url of urls ) {
  GM_download({
    url: `${url}`,
    name: `test-file${++i}.zip`,
    confirm: false,
    tag: "test-file"
  });
}

GM_getResourceText

描述

获取元数据标记@resource指向资源的文本内容。

语法

function GM_getResourceText(name)

参数

名称 类型 描述
name 字符串 标记@resource 定义的用于引用资源的键值名称

示例

// @resource     main-content https://www.xiaobai.wang/res/main-content.txt
var text = GM_getResourceText("main-content");

返回值

返回资源URL的文本内容。

GM_getResourceURL

描述

获取元数据标记@resource 指向资源的内容， 内容以Base64编码，格式为Data URI格式。

语法

function GM_getResourceURL(name)

参数

名称 类型 描述
name 字符串 标记@resource 定义的用于引用资源的键值名称

示例

var img = document.querySelector("#avatar")
//@resource     avatar01 https://api.multiavatar.com/avatar01.svg
img.src = GM_getResourceURL("avatar01");

返回值

返回以Base64编码的Data URI。

GM_xmlhttpRequest

描述

这个方法类似于XMLHttpRequest 对象, 不同的是此方法支持跨域请求，突破了对象同源访问策略,使用起来更加灵活。

语法

function GM_xmlhttpRequest(details)

参数

这个方法只有对象类型的参数details ，对象的属性列表和含义如下：

名称 类型 描述
details 对象 包含一系列属性作为控制参数

details 属性说明

  • method - Http请求方法，GET、POST、HEAD等。
  • url - 字符串，目标请求URL。
  • headers - 可选项，字符串，HTTP协议头，User-Agent，Referer等。
  • data - 可选项，字符串，通过POST方法发送的数据
  • responseType - 可选项，字符串，设置响应类型，可以为arraybuffer, blob, json 和 stream 之一。
  • onabort- 可选项，回调函数，当HTTP请求被终止时调用。
  • onerror- 可选项，回调函数，HTTP请求出现异常时被调用
  • onloadstart - 可选项，回调函数，HTTP请求开始被调用
  • onreadystatechange - 可选项，回调函数，HTTP请求状态变化被调用
  • onload - 可选项，回调函数，当HTTP请求完成时被调用，回调函数参数携带的几个属性如下
    • finalUrl - HTTP 最终请求的URL地址，比如最后重定向的网址。
    • readyState - 数据状态
    • status - HTTP请求状态
    • statusText - HTTP请求状态文本
    • responseHeaders - HTTP响应头
    • response - HTTP响应返回的对象类型数据，当 details.responseType 被设置返回相应类型的对象。
    • responseText - 返回文本类型的数据

示例

//发起一个get请求
GM_xmlhttpRequest({
  method: "GET",
  url: "http://www.xiaobai.wang/",
  onload: function(response) {
    alert(response.responseText);
  }
});
//发起一个post请求
GM.xmlHttpRequest({
  method: "POST",
  url: "https://www.example.net/login",
  data: "username=johndoe&password=xyz123",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded"
  },
  onload: function(response) {
    if (response.responseText.indexOf("Logged in as") > -1) {
      location.href = "http://www.example.net/dashboard";
    }
  }
});

GM_info

这是一个对象，用来保存每个脚本的相关环境变量，比如脚本的版本、作者、介绍等，对象属性列表如下：

  • script - 对象类型，包含下面一些属性。
    • author - 脚本作者
    • name - 脚本名称
    • description - 脚本介绍
    • version - 版本
    • copyright - 版权信息
    • includes - 数组类型，包含匹配页面的列表
    • matches - 数组类型，和includes类似，包含匹配页面的列表
    • excludes -数组类型，排除匹配网址列表
    • resources - 数组类型，所有资源列表
  • version - 脚本管理器的版本
  • scriptHandler - 脚本管理器的名称
  • scriptMetaStr - 脚本管理器元数据字符串

示例

var info = "Script Name: "  + GM_info.script.name + 
    "\nVersion: " + GM_info.script.version + 
    "\nVersion: " + GM_info.script.version + 
    "\nScriptHandler: " + GM_info.scriptHandler + 
    "\nScript Handler Version : " + GM_info.version ;

alert(info);

参考资料

取自“https://www.xiaobai.wang/index.php?title=Greasemonkey_API&oldid=837”
上一节: Greasemonkey_元数据
此页面最后编辑于2022年8月9日 (星期二) 21:37。