This value is used to report an error message from an asynchronous API, when the asynchronous API is given a callback. This is useful for extensions that are using the callback-based version of the WebExtension APIs.

You don't need to check this property if you are using the promise-based version of the APIs: instead, pass an error handler to the promise:

const gettingCookies = browser.cookies.getAll();gettingCookies.then(onGot, onError);

Theruntime.lastError property is set when an asynchronous function has an error condition that it needs to report to its caller.

If you call an asynchronous function that may setlastError, you are expected to check for the error when you handle the result of the function. IflastError has been set and you don't check it within the callback function, then an error will be raised.

Syntax

let myError = browser.runtime.lastError;  // null or Error object

Value

AnError object representing the error. Themessage property is astring with a human-readable description of the error. IflastError has not been set, the value isnull.

Examples

Set a cookie, using a callback to log the new cookie or report an error:

function logCookie(c) {  if (browser.runtime.lastError) {    console.error(browser.runtime.lastError);  } else {    console.log(c);  }}browser.cookies.set({ url: "https://developer.mozilla.org/" }, logCookie);

The same, but using a promise to handle the result ofsetCookie():

function logCookie(c) {  console.log(c);}function logError(e) {  console.error(e);}const setCookie = browser.cookies.set({  url: "https://developer.mozilla.org/",});setCookie.then(logCookie, logError);

Example extensions

• menu-demo

Browser compatibility