chrome.app.runtime

描述 使用 chrome.app.runtime API 管理应用的生命周期。应用运行时环境管理应用的安装,控制事件页面,并且可以在任何时候关闭应用。
可用版本 从 Chrome 23 开始支持。

摘要

事件
onEmbedRequested
onLaunched
onRestarted

事件

onEmbedRequested

从 Chrome 38 开始支持。警告:目前为 Dev 分支。了解更多内容

其他应用请求嵌入该应用时产生。该事件仅在 Dev 分支上,并且指定 --enable-app-view 参数的情况下才可用。

addListener

chrome.app.runtime.onEmbedRequested.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function(object request) {...};
object request
string embedderId
any (可选)
data

尚未完全实现,您必须通过源代码建立 Chromium 才能尝试该 API。了解更多内容

开发者指定的可选数据,嵌入的应用可以利用它决定嵌入后的行为。

function allow

允许 embedderId 通过 <appview> 元素嵌入该应用,url 指定要嵌入的内容。

参数
string url
function deny

阻止 embedderId 通过 <appview> 元素嵌入该应用。

onLaunched

应用从执行器执行时产生。

addListener

chrome.app.runtime.onLaunched.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function(object launchData) {...};
object (可选)
launchData
string (可选)
id

从 Chrome 25 开始支持。

调用应用的文件处理器标识符。处理器标识符为清单文件中 file_handlers 和/或 url_handlers 词典中的顶层键。

array of object (可选)
items

从 Chrome 25 开始支持。

匹配清单文件 file_handlers 中的文件处理器而触发的 onLaunched 事件的文件项。

每一个对象的属性

FileEntry entry

文件的 FileEntry

string type

文件的 MIME 类型。

string (可选)
url

从 Chrome 31 开始支持。

匹配清单文件 url_handlers 中的 URL 处理器而触发的 onLaunched 事件的 URL。

string (可选)
referrerUrl

从 Chrome 31 开始支持。

匹配清单文件 url_handlers 中的 URL 处理器而触发的 onLaunched 事件的引用 URL。

boolean (可选)
isKioskSession

从 Chrome 31 开始支持。

应用是否在 Chrome OS 信息亭模式下启动。

onRestarted

从 Chrome 24 开始支持。

当 Chrome 浏览器启动时产生,用于 Chrome 浏览器上一次关闭时正在运行的应用。

addListener

chrome.app.runtime.onRestarted.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function() {...};