Chrome浏览器扩展开发系列之十六：扩展中可用的Chrome浏览器API

除了Chrome浏览器支持的chrome.* API之外，Chrome浏览器扩展还可以使用Chrome浏览器为Web页面或Chrome app提供的APIs。对于Chrome浏览器2支持的API，还可以绑定第三方API库到Chrome浏览器扩展程序。

Chrome浏览器扩展程序可以使用的API包括：

• 标准JavaScript API，即Web应用中常用的JavaScript核心API和DOM API
• XMLHttpRequest API
• HTML5 API
• WebKit API，特别是WebKit的CSS特性，如过滤器、动画和变换
• Chrome V8 API，如JSON
• 其他第三方类库API，如jQuery，可以绑定这些API到Chrome浏览器扩展程序，就如同在Web页面中使用这些API

本系列将首先介绍一些常用的Chrome浏览器API。

1. Chrome sessions API

Chrome浏览器扩展程序通过chrome.sessions API，可以从浏览器的会话中存取windows窗口和tab页。

chrome.sessions.Session对象的属性如下：

chrome.sessions API中的常用方法：

• 获得最近被关闭的windows窗口或tab页的列表

chrome.sessions.getRecentlyClosed(Filter filter, function(array of Session))

• 获得同步会话中的所有设备

chrome.sessions.getDevices(Filter filter, function(array of Session))

• 恢复打开指定会话中的窗口或tab页

chrome.sessions.restore(string sessionId, function(Session session))

2. Chrome windows API

Chrome浏览器扩展程序通过chrome.windows API，可以与浏览器的窗口系统交互，如创建浏览器窗口、修改浏览器窗口和重新编排浏览器窗口。

chrome.windows API本身无需声明任何授权。但是一个chrome.windows.Window对象包含一个chrome.tabs.Tab类型的数组，如果要操作数组中的tabs的url、title、favIconUrl属性，则需要在manifest.json文件中声明tabs授权如下：

            1
            {

            2
                    ...

            3
            "
            permissions
            "
            : [

            4
            "
            tabs
            "
            5
                    ],

            6
                    ...

            7 }

当前窗口是包含正在运行的JavaScript代码的窗口。这与当前拥有焦点的窗口可能不是同一个窗口。

chrome.windows.Window对象的属性如下：

chrome.tabs API中的常用方法：

• 创建一个新的浏览器窗口

chrome.windows.create(object createData, function(Window window){…})

createData对象是可选的，表示采用默认值创建窗口。createData对象的属性同chrome.windows.Window对象。

• 关闭一个指定的浏览器窗口

chrome.windows.remove(integer windowId, function(){…})

• 修改一个指定的浏览器窗口的参数

chrome.windows.update(integer windowId, object updateInfo, function(Window window){…})

updateInfo对象是必选的，其中未涉及的Window属性则保持不变。

• 获取指定ID的窗口对象

chrome.windows.get(integer windowId, object getInfo, function(Window window){…})

getInfo对象是可选的，其有两个参数。一个是名为populate的布尔型参数，true表示该方法得到的chrome.windows.Window对象里包含chrome.tabs.Tab类型的数组。另一个名为windowTypes的WindowType型参数，表示通过windowTypes进行筛选窗口。

• 获取所有的窗口对象

chrome.windows.getAll(object getInfo, function(array of Window){…})

getInfo对象是可选的，其有两个参数。一个是名为populate的布尔型参数，true表示该方法得到的chrome.windows.Window对象里包含chrome.tabs.Tab类型的数组。另一个名为windowTypes的WindowType型参数，表示通过windowTypes进行筛选窗口。

 3. Chrome tabs API

Chrome浏览器扩展程序通过chrome.tabs API，可以与浏览器的tab系统交互，如创建浏览器tab、修改浏览器tab和重新编排浏览器tabs。

大多数chrome.tabs API无需声明任何授权，但是如果要操作tab的url、title、favIconUrl属性，则需要在manifest.json文件中声明tabs授权如下：

            1
            {

            2
                    ...

            3
            "
            permissions
            "
            : [

            4
            "
            tabs
            "
            5
                    ],

            6
                    ...

            7 }

chrome.tabs.Tab对象的属性如下：

chrome.tabs API中的常用方法：

• 创建一个新tab

chrome.tabs.create(object createProperties, function(Tab tab){…})

createProperties对象的属性如下：

• 复制一个新tab

chrome.tabs.duplicate(integer tabId, function(Tab tab){…})

• 关闭tabs

chrome.tabs.remove(integer or array of integer tabIds, function(){…})

• 修改tab的属性

chrome.tabs.update(integer tabId, object updateProperties, function(Tab tab){…})

updateProperties对象是必选的，其中未涉及的tab属性则保持不变。

• 获取指定id的tab

chrome.tabs.get(integer tabId, function(Tab tab){…})

• 根据指定的若干属性查找tabs

chrome.tabs.query(object queryInfo, function(array of Tab){…})

queryInfo对象的属性如下：

• 注入JavaScript代码到页面中

chrome.tabs.executeScript(integer tabId, object details, function(array of any){…})

details对象的属性如下：

• 注入CSS文件到页面中

chrome.tabs.insertCSS(integer tabId, object details, function(){…})

details对象的属性同executeScript()。

原文：http://www.cnblogs.com/champagne/p/4872286.html