Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

In the Open Web apps JavaScript API, an App object is a JavaScript object that represents an app that is or could be installed in the user's app repository.

Properties

Name Description Type
manifest The currently stored instance of the manifest of the app. object
manifestURL Where the manifest was found. string
origin The origin of the app (protocol, host, and optional port number). For example: https://example.com string
installOrigin The origin of the site that triggered the installation of the app. string
installTime The time that the app was installed. This is generated using Date().getTime(), represented as the number of milliseconds since midnight of January 1st, 1970. integer
receipts An object containing an array of one or more receipts. Each receipt is a string. If there are no receipts, this is null. object or null
state The enabled state of the current application. enabled or disabled

Methods

Method Description
addReceipt() Adds a receipt to the app after an in-app purchase has been made.
launch() Launches the application. Does not return any value.
checkForUpdate()

Check to see if the app has been updated. Returns a DOMRequest object.

For packaged apps: check for updates and mark it as downloadavailable if needed.

For hosted apps: check for updates on app manifest and application cache and update it if needed.

removeReceipt() Removes a receipt from the app after an in-app purchase has been cancelled.
replaceReceipt() Replaces one receipt with another.

Example App object

{
  manifest: {
    name: "Add-on Builder",
    default_locale: "en",
    installs_allowed_from: [
      "https://apps-preview-dev.example.com/",
      "https://apps-preview.example.com/"
    ],
    description: "Add-on Builder makes it easy to write, build and test Firefox extensions using common web technologies.",
    version: "0.9.16.1",
    developer: {
      url: "https://builder.addons.mozilla.org/",
      name: "Mozilla Flightdeck Team"
    }
  },
  origin: "https://builder-addons-dev.example.com",
  installTime: 1321986882773,
  installOrigin: "https://apps-preview-dev.example.com",
  receipts: ["h0dHBzOi8v (most of receipt removed here) Tg2ODtkUp"]
}

Document Tags and Contributors

 Last updated by: chrisdavidmills,