chrome.app.runtime

说明

使用 chrome.app.runtime API 管理应用生命周期。应用运行时管理应用安装、控制事件页面，并且可以随时关闭应用。

类型

ActionData

Chrome 54 及更高版本

属性

  • actionType

    "new_note"

ActionType

Chrome 54 及更高版本

用户在启动应用时可以记住执行特定操作，例如创建新记事。LaunchData 实例的 actionData 字段内提供了应用启动时所用的操作类型。

值

"new_note"

EmbedRequest

属性

  • 数据

    任何选填字段

    （可选）要嵌入的应用在做出嵌入决策时可以使用的开发者指定数据。

  • embedderId

    字符串

  • allow

    void

    允许embedderId在 <appview> 中嵌入此应用元素。url 指定要嵌入的内容。

    allow 函数如下所示： 

    (url: string) => {...}

    • 网址

      字符串

  • deny

    void

    阻止 embedderId 将此应用嵌入 <appview>元素。

    deny 函数如下所示： 

    () => {...}

LaunchData

属性

  • actionData

    ActionData（可选）

    Chrome 54 及更高版本

    包含用于指定此应用启动时所用的 ActionType 的数据。如果应用未通过特定操作 intent 启动，则为 null。

  • id

    字符串（可选）

    调用应用的文件或网址处理程序的 ID。处理程序 ID 是清单中 file_handlers 和/或 url_handlers 字典中的顶级键。

  • isKioskSession

    布尔值（可选）

    应用是否在 Chrome 操作系统自助服务终端会话中启动。

  • isPublicSession

    布尔值（可选）

    Chrome 47 及更高版本

    应用是否是在 Chrome 操作系统公用自助终端中启动。

  • items

    LaunchItem[] 可选

    由 file_handlers 清单键中的匹配文件处理程序触发的 onLaunched 事件的文件条目。

  • referrerUrl

    字符串（可选）

    由 url_handlers 清单键中的匹配网址处理程序触发的 onLaunched 事件的引荐来源网址。

  • 来源

    LaunchSource 可选

    应用的启动位置。

  • 网址

    字符串（可选）

    由 url_handlers 清单键中的匹配网址处理程序触发的 onLaunched 事件的网址。

LaunchItem

属性

  • 入口

    条目

    商品的条目。

  • 类型

    字符串（可选）

    文件的 MIME 类型。

LaunchSource

应用启动来源的枚举。这应与 extensions/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource 和 extensions/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。请注意，枚举已用在 UMA 直方图中，因此不应对条目重新排序或移除条目。

枚举

"未跟踪"

&quot;app_launcher&quot;

"new_tab_page"

"重新加载"

“重启”

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

“url_handler”

"system_tray"

“about_page”

"键盘"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

“background”

“信息亭”

“chrome_internal”

“测试”

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arc"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"sparky"

事件

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

在嵌入应用请求嵌入此应用时触发。此事件仅在开发渠道上提供，带有标志 --enable-app-view。

参数

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

从启动器启动应用时触发。

参数

  • callback

    函数

    callback 参数如下所示： 

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

在 Chrome 启动到正在运行的应用时触发，当 Chrome 上次关闭时，或者由于其他原因（例如，当用户撤消对应用保留的文件的访问权限）要求应用重启时（例如，当用户撤消对应用保留的文件的访问权限时，运行时会重启应用）。在这些情况下，如果应用没有 onRestarted 处理程序，系统会改为向应用发送 onLaunched 事件。

参数

  • callback

    函数

    callback 参数如下所示： 

    () => void