谷歌插件的扩展方法

mac2022-06-30  94

chrome.tabs.create(object createProperties, function callback)

创建新的标签。注: 无需请求manifest的标签权限,此方法也可以被使用。

Parameters

createProperties  object  windowId  optional创建新标签的目标窗口。默认是 当前窗口 。 index  optional标签在窗口中的位置。 值在零至标签数量之间。 url  optional标签导航的初始页面。完整的URL 必须包含一个前缀 (如 'http://www.google.com', 不能写为 'www.google.com')。 相对 URL则与扩展所在的页面相对, 默认值为新标签页面。 selected  optional标签是否成为选中标签。默认为true。 pinned  optional标签是否被固定。默认值为false。 callback  optional

Callback function

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  Tab 所创建的标签的细节,包含新标签的ID。

get

chrome.tabs.get( integer tabId, function callback)

获取指定标签的细节信息。

Parameters

tabId  integer  callback  function 

回调函数

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  Tab 

getAllInWindow

chrome.tabs.getAllInWindow( integer windowId, function callback)

获取指定窗口所有标签的细节信息。

Parameters

windowId  optional默认为 当前窗口。 callback  function 

回调函数

T 回调 参数 应该如下定义:

function(array of Tab tabs) {...}; tabs  array of Tab 

getCurrent

chrome.tabs.getCurrent( function callback)

获取生成脚本调用的标签。此函数不适用于脚本被非标签内容调用的情况。(例如: 背景页 或者 弹出视图) 。

Parameters

callback  function 

回调函数

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  optional

getSelected

chrome.tabs.getSelected( integer windowId, function callback)

获取特定窗口指定的标签。

Parameters

windowId  optional默认为 当前窗口。 callback  function 

回调函数

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  Tab 

insertCSS

chrome.tabs.insertCSS( integer tabId, object details, function callback)

向页面注入CSS。要了解详情,请参阅内容脚本文档中的 programmatic injection 部分。

Parameters

tabId  optional要注入CSS的标签ID;默认为当前窗口选定的标签。 details  object 要注入的CSS的内容,可选code或者file,但不能同时选两者。 code  optional要注入的CSS代码。 file  optional要注入的CSS文件。 allFrames  optionaltrue的时候,给所有frame注入CSS。默认为false,只给顶级frame注入CSS。 callback  optional当所有的CSS 被注入后,回调被调用。

回调函数

回调 参数 应该如下定义:

function() {...};

move

chrome.tabs.move( integer tabId, object moveProperties, function callback)

把标签移动至窗口内特定的位置,或者移至一个新窗口。请注意只能在普通窗口之间切移(window.type === "normal") 。

Parameters

tabId  integer  moveProperties  object  windowId  optional默认为标签所在的窗口。 index  integer 移动到的目标窗口位置。赋值必须在零至目标窗口的标签数目之间。 callback  optional

回调函数

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  Tab 所被移动的标签细节。

remove

chrome.tabs.remove( integer tabId, function callback)

关闭标签。

Parameters

tabId  integer  callback  optional

回调函数

回调 参数 应该如下定义:

function() {...};

sendRequest

chrome.tabs.sendRequest( integer tabId, any request, function responseCallback)

向特定的标签content script发送一个的请求, 并在响应返回时,可附带一个回调。在所有content script响应请求后,chrome.extension.onRequest 事件将会为当前扩展触发。

Parameters

tabId  integer  request  any  responseCallback  optional
Parameters
response  any 响应的JSON对象。如果错误发生,回调将不会有参数。并会在  chrome.extension.lastError 产生一个错误。

回调函数

回调 参数 应该如下定义:

function(any response) {...}; response  any 响应的JSON对象。如果错误发生,回调将不会有参数。并会在  chrome.extension.lastError 产生一个错误。

update

chrome.tabs.update( integer tabId, object updateProperties, function callback)

修改标签的属性。没有在updateProperties 中指定的属性不会被修改。注:即使没有向manifest 请求'tabs'权限,这个方法依然适用。

Parameters

tabId  integer  updateProperties  object  url  optional让标签浏览的URL。 selected  optional标签是否应被选中。 pinned  optional标签是否应被固定。 callback  optional

回调函数

回调 参数 应该如下定义:

function(Tab tab) {...}; tab  Tab 被更新的标签细节。

Events

onAttached

chrome.tabs.onAttached.addListener(function(integer tabId, object attachInfo) {...});

当标签附着在窗口上,此事件被触发。例如,此事件会发生在标签在窗口之前移动时。

Parameters

tabId  integer  attachInfo  object  newWindowId  integer  newPosition  integer 

onCreated

chrome.tabs.onCreated.addListener(function(Tab tab) {...});

标签创建时,此事件触发。请注意,当事件触发时,标签的 URL 可能没有被设置, 但是当URL被设置时,可以通过onUpdated 事件接听。

Parameters

tab  Tab 标签创建的细节。

onDetached

chrome.tabs.onDetached.addListener(function(integer tabId, object detachInfo) {...});

当标签从窗口脱离时,此事件被触发,例如标签在窗口之间移动。

Parameters

tabId  integer  detachInfo  object  oldWindowId  integer  oldPosition  integer 

onMoved

chrome.tabs.onMoved.addListener(function(integer tabId, object moveInfo) {...});

当标签在窗口内移动时,此事件被触发。只有一个移动事件被触发,给用户直接移动的标签。其他响应移动事件的标签不触发移动事件。 请参阅 onDetached.查看详情。

Parameters

tabId  integer  moveInfo  object  windowId  integer  fromIndex  integer  toIndex  integer 

onRemoved

chrome.tabs.onRemoved.addListener(function(integer tabId, object removeInfo) {...});

标签关闭时被触发。

Parameters

tabId  integer  removeInfo  object  isWindowClosing  boolean 当窗口被关闭,标签随之被关闭时,此参数为true。

onSelectionChanged

chrome.tabs.onSelectionChanged.addListener(function(integer tabId, object selectInfo) {...});

当窗口选中的标签改变时,此事件触发

Parameters

tabId  integer 被选中标签的ID。 selectInfo  object  windowId  integer 标签发生变化的窗口ID。

onUpdated

chrome.tabs.onUpdated.addListener(function(integer tabId, object changeInfo, Tab tab) {...});

当标签更新时,此事件被触发。

Parameters

tabId  integer  changeInfo  object 列出标签更新时的状态。 status  optional标签的状态。可以为  loading or  complete。 url  optional经历变化的标签的URL。 pinned  optional标签被锁定的新状态。 tab  Tab 更新的标签的状态。

Types

Tab

object  id  integer 标签ID。在一个浏览器会话内, 标签ID是唯一的。 index  integer 窗口内从零开始的标签索引。 windowId  integer 标签所在窗口的窗口ID。 selected  boolean 标签是否被选中。 pinned  boolean 标签是否被锁定。 url  string 标签所显示的URL。 title  optional标签的标题。当标签被加载时,标题可能不能被成功获取。 favIconUrl  optional标签收藏夹图标的URL。当标签被加载时,图标可能不能被成功获取。 status  optional可以被设置为  loading 或者  complete。 incognito  boolean 可以被设置为  loading 或者  complete.   -------------------- From 360极速浏览器开放平台

转载于:https://www.cnblogs.com/smallDesert/p/5402907.html

相关资源:Google Chrome Backup 谷歌浏览器扩展备份工具
最新回复(0)