chrome.app.runtime
- Description
Use the
chrome.app.runtime
API to manage the app lifecycle. The app runtime manages app installation, controls the event page, and can shut down the app at anytime.
Summary
- Types
- Events
Types
ActionData
Properties
- actionType
"new_note"
ActionType
An app can be launched with a specific action in mind, for example, to create a new note. The type of action the app was launched with is available inside of the actionData
field from the LaunchData instance.
Value
"new_note"
EmbedRequest
Properties
- data
any optional
Optional developer specified data that the app to be embedded can use when making an embedding decision.
- embedderId
string
- allow
function
Allows
embedderId
to embed this app in an <appview> element. Theurl
specifies the content to embed.The
allow
function looks like:(url: string) => {...}
- url
string
- deny
function
Prevents
embedderId
from embedding this app in an <appview> element.The
deny
function looks like:() => {...}
LaunchData
Properties
- actionData
ActionData optional
Chrome 54+Contains data that specifies the
ActionType
this app was launched with. This is null if the app was not launched with a specific action intent. - id
string optional
The ID of the file or URL handler that the app is being invoked with. Handler IDs are the top-level keys in the
file_handlers
and/orurl_handlers
dictionaries in the manifest. - isKioskSession
boolean optional
Whether the app is being launched in a Chrome OS kiosk session.
- isPublicSession
boolean optional
Chrome 47+Whether the app is being launched in a Chrome OS public session.
- items
LaunchItem[] optional
The file entries for the
onLaunched
event triggered by a matching file handler in thefile_handlers
manifest key. - referrerUrl
string optional
The referrer URL for the
onLaunched
event triggered by a matching URL handler in theurl_handlers
manifest key. - source
LaunchSource optional
Where the app is launched from.
- url
string optional
The URL for the
onLaunched
event triggered by a matching URL handler in theurl_handlers
manifest key.
LaunchItem
Properties
- entry
Entry
Entry for the item.
- type
string optional
The MIME type of the file.
LaunchSource
Enumeration of app launch sources. This should be kept in sync with AppLaunchSource in components/services/app_service/public/mojom/types.mojom, and GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc. Note the enumeration is used in UMA histogram so entries should not be re-ordered or removed.
Type
"untracked"
,"app_launcher"
,"new_tab_page"
,"reload"
,"restart"
,"load_and_launch"
,"command_line"
,"file_handler"
,"url_handler"
,"system_tray"
,"about_page"
,"keyboard"
,"extensions_page"
,"management_api"
,"ephemeral_app"
,"background"
,"kiosk"
,"chrome_internal"
,"test"
,"installed_notification"
,"context_menu"
,"arc"
,"intent_url"
, or"app_home_page"
Events
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback:
function,
)
Fired when an embedding app requests to embed this app. This event is only available on dev channel with the flag --enable-app-view.
Parameters
- callback
function
The
callback
parameter looks like:(request: EmbedRequest) => void
- request
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback:
function,
)
Fired when an app is launched from the launcher.
Parameters
- callback
function
The
callback
parameter looks like:(launchData?: LaunchData) => void
- launchData
LaunchData optional
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback:
function,
)
Fired at Chrome startup to apps that were running when Chrome last shut down, or when apps have been requested to restart from their previous state for other reasons (e.g. when the user revokes access to an app's retained files the runtime will restart the app). In these situations if apps do not have an onRestarted
handler they will be sent an onLaunched
event instead.
Parameters
- callback
function
The
callback
parameter looks like:() => void