# Share: Frontend App Messaging

Apps can share messages with each other by using these interfaces.

# Functions

# edger.app.open(target[, letter])

• target {Object} Target App information.
• letter {Object} A letter message send to target. Default: undefined.
• Returns: {Promise} Promise object.

Send a message to the target App. If the target App is not running, EdgerOS will launch the target App and switch it to the foreground, if the target App is already running, EdgerOS will switch it to the foreground.

The target object contains the following members:

• id {String} Target App bundle ID, for example: 'com.acoinfo.setting'.

The letter object contains the following members:

• type {String} Types of messages shared. This is defined by the target App. Check below "Support" table for more information.
• msg {Object} Message sent to the target.

# Example

edger.app.open({ id: 'com.acoinfo.setting' }, {
  type: 'about',
  msg: {
    ...
  }
}).then((data) => {
  if (data.success) {
    console.log('Letter send ok!');
  }
}).catch(error => {
  console.error(error);
});

# async / await

async function share(id, type, msg) {
  const ret = await edger.app.open({ id }, { type, msg });
  return ret.success;
}

# edger.app.appworld(id)

• id {String} Target App id, for example: 'com.company.appname'.
• Returns: {Promise} Promise object.

Open the specified App page in EdgerWorld.

# Example

edger.app.appworld('com.acoinfo.setting').then((data) => {
  if (data.success) {
    console.log('ok!');
  }
}).catch(error => {
  console.error(error);
});

# async / await

async function appworld(id) {
  const ret = await edger.app.appworld(id);
  return ret.success;
}

# edger.app.browser(url)

• url {String} Target url.
• Returns: {Promise} Promise object.

Open url in browser.

# Example

// If you do not have browser permission, please apply first
const weWantPerms = ['browser'];
edger.permission.request({
  code: weWantPerms,
  type: 'phone'
}).then((ret) => {
  if (!ret.success) return
  edger.app.browser('https://www.edgeros.com/').then((data) => {
    if (data.success) {
      console.log('ok!');
    }
  }).catch(error => {
    console.error(error);
  });
})

# edger.app.letter()

• Returns: {Promise} Promise object.

Get the latest letter information, EdgerOS reserves a letter message for each App front-end, which can be obtained through this interface, which is generally called in the active event detection function.

# Example

edger.onAction(`active`, () => {
  edger.app.letter().then((letter) => {
    if (letter != undefined) {
      // The current app got a letter
    }
  }).catch(error => {
    console.error(error);
  });
});

The obtained letter object contains the following members:

• type {String} Type information from the sender.
• msg {Object} Message from the sender.
• from {String} Sender App bundle ID.

# Support

# edger.app.open(target[, letter]) supports the following features

The following APIs are provided for development to open corresponding functions.

The feature field represents a specific system function. You can directly enter the corresponding system functions through the corresponding parameters.

# Setting app commands support list (Bundle ID: com.acoinfo.setting)

# Device app commands support list (Bundle ID: com.acoinfo.device)

# Lora app commands support list (Bundle ID: com.acoinfo.lora)

# Router app commands support list (Bundle ID: com.acoinfo.router)

# Edgerworld app commands support list (Bundle ID: com.acoinfo.edgerworld)

# User app commands support list (Bundle ID: com.acoinfo.user)

# Nas app commands support list (Bundle ID: com.acoinfo.nas)

# Printer app commands support list (Bundle ID: com.acoinfo.printer)

# Thinc app commands support list (Bundle ID: com.acoinfo.thinc)

# Homecast app commands support list (Bundle ID: com.acoinfo.homecast)

# Guide app commands support list (Bundle ID: com.acoinfo.guide)

# Example

The following code will open the Setting app, and switch to the About function.

edger.app.open({ id: 'com.acoinfo.setting' }, {
  type: 'about',
  msg: {}
}).then((data) => {
  if (data.success) {
    console.log('Letter send ok!');
  }
}).catch(error => {
  console.error(error);
});

# async / await

async function share(id, type, msg) {
  const ret = await edger.app.open({ id }, { type, msg });
  return ret.success;
};
share('com.acoinfo.setting', 'about')