Notification API

Methods

post

Posts a notification to display.

void post(Notification notification);

Since: 2.3.1

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• notification: A notification to post.

Exceptions:

• WebAPIException

  • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  var appControl = new tizen.ApplicationControl(
      "http://tizen.org/appcontrol/operation/create_content", null, "image/jpg", null);
  var notificationDict =
  {
    content: "This is a simple notification.",
    iconPath: "images/image1.jpg",
    soundPath: "music/Over the horizon.mp3",
    vibration: true,
    appControl: appControl
  };

  var notification =
      new tizen.StatusNotification("SIMPLE", "Simple notification", notificationDict);

  tizen.notification.post(notification);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

update

Updates a previously posted notification.

void update(Notification notification);

Since: 2.3.1

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• notification: A notification to update.

Exceptions:

• WebAPIException

  • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  notification.content = "My notification";
  tizen.notification.update(notification);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

remove

Removes a previously posted notification.

void remove(NotificationId id);

Since: 2.3.1

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Parameters:

• id: A previously posted notification ID to remove.

Exceptions:

• WebAPIException

  • with error type NotFoundError, if NotificationId is not found in the previously posted notification.

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  tizen.notification.remove(notification.id);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

removeAll

Removes all notifications that have been posted by the current application.

void removeAll();

Since: 2.3.1

Privilege level: public

Privilege: http://tizen.org/privilege/notification

Exceptions:

• WebAPIException

  • with error type SecurityError, if the application does not have the privilege to call this method.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  tizen.notification.removeAll();
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

get

Gets a notification that has previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE

Notification get(NotificationId id);

Since: 2.3.1

Parameters:

• id: A previously posted notification ID.

Return value:

Notification: Notification posted previously by the current application.

Exceptions:

• WebAPIException

  • with error type NotFoundError, if NotificationId is not found in the previously posted notifications.

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  /* Uses a variable for the previously posted notification. */
  /* Saves the notification ID for future use. */
  var myId = notification.id;

  var myNotification = tizen.notification.get(myId);
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}

getAll

Gets all notifications that have previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE

Notification[] getAll();

Since: 2.3.1

Return value:

Notification[]: All notifications previously been posted by the current application.

Exceptions:

• WebAPIException

  • with error type UnknownError, if any other error occurs.

Code example:

try
{
  var notifications = tizen.notification.getAll();

  for (var index = 0; index < notifications.length; index++)
  {
    console.log(notifications[index].id);
    console.log(notifications[index].title);
    console.log(notifications[index].statusType);
    console.log(notifications[index].type);
    console.log(notifications[index].content);
    console.log(notifications[index].postedTime);
    console.log(notifications[index].iconPath);
    console.log(notifications[index].soundPath);
    console.log(notifications[index].vibration);
    console.log(notifications[index].appControl);
  }
}
catch (err)
{
  console.log(err.name + ": " + err.message);
}