Adding user data to the notification options.

chrome/common/extensions/api/experimental_notification.idl

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [nodoc] namespace experimental.notification {
   enum TemplateType {
     // icon, title, message
     simple,
 
     // icon, title, message, expandedMessage, up to two buttons
@@ skipping 47 matching lines @@
     NotificationButton[]? buttons;
 
     // Secondary notification content.
     DOMString? expandedMessage;
 
     // Image thumbnail for image-type notifications.
     DOMString? imageUrl;
 
     // Items for multi-item notifications.
     NotificationItem[]? items;
+
+    // Object specifying user data for the notification. Values that cannot be
+    // serialized (functions, etc) will be ignored.
+    object? userData;
   };
 
   callback CreateCallback = void (DOMString notificationId);
 
   callback UpdateCallback = void (boolean wasUpdated);
 
   callback ClearCallback = void (boolean wasCleared);
 
+  // |useData| is NotificationOptions.userData that was passed to create/update
+  // call, if was specified, null otherwise.
+  callback GetCallback = void (object userData);
+
+  // |notifications| is a map from all notifications IDs of all notifications
+  // to their userData objects, if were specified, otherwise, nulls.
+  callback GetAllCallback = void (object notifications);
+
   interface Functions {
     // Creates and displays a notification having the contents in |options|,
     // identified by the id |notificationId|. If |notificationId| is empty,
     // |create| generates an id. If |notificationId| matches an existing
     // notification, |create| first clears that notification before proceeding
     // with the create operation. |callback| returns the notification id
     // (either supplied or generated) that represents the created notification.
     static void create(DOMString notificationId,
                        NotificationOptions options,
                        CreateCallback callback);
 
     // Updates an existing notification having the id |notificationId| and the
     // options |options|. |callback| indicates whether a matching notification
     // existed.
     static void update(DOMString notificationId,
                        NotificationOptions options,
                        UpdateCallback callback);
 
     // Given a |notificationId| returned by the |create| method, clears the
     // corresponding notification. |callback| indicates whether a matching
     // notification existed.
     static void clear(DOMString notificationId, ClearCallback callback);
+
+    static void clearAll();
+
+    static void get(DOMString notificationId, GetCallback callback);
+
+    // Returns to |callback| ids and user data of all locally created
+    // notifications.
+    static void getAll(GetAllCallback callback);
   };
 
   interface Events {
     // The system displayed the notification. Not all created notifications are
     // displayed; for example, a low-priority notification might simply appear
     // in the message center without interrupting the user.
     static void onDisplayed(DOMString notificationId);
 
     // The notification closed, either by the system or by user action.
-    static void onClosed(DOMString notificationId, boolean byUser);
+    static void onClosed(DOMString notificationId,
+                         boolean byUser,
+                         object userData);
 
     // The user clicked in a non-button area of the notification.
-    static void onClicked(DOMString notificationId);
+    static void onClicked(DOMString notificationId,
+                          object userData);
 
     // The user pressed a button in the notification.
-    static void onButtonClicked(DOMString notificationId, long buttonIndex);
+    static void onButtonClicked(DOMString notificationId,
+                                long buttonIndex,
+                                object userData);
   };
 
 };