Add SetImageData api to chrome.clipboard.

extensions/common/api/clipboard.idl

 // Copyright (c) 2016 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.
 
 // The <code>chrome.clipboard</code> API is provided to allow users to
 // access data of the clipboard. This API is currently only implemented for
 // ChromeOS.
 namespace clipboard {
+  // Image data types: 
+  enum ImageType {png, jpeg};
+  
   interface Events {
     // Fired when clipboard data changes.
     // Requires clipboard and clipboardRead permissions for adding listener to
     // chrome.clipboard.onClipboardDataChanged event.
     // After this event fires, the clipboard data is available by calling
     // document.execCommand('paste').
     static void onClipboardDataChanged();
   };
+
+  callback SetImageDataCallback = void(boolean success);
+
+  interface Functions {
+    // Sets image data to clipboard.
+    //
+    // |image_data|: The encoded image data.
+    // |type|: The image type,  the supported types are: "png", "jpeg".
+    static void setImageData(ArrayBuffer image_data,
+                             ImageType type,
+                             SetImageDataCallback callback);

[Devlin, 2016/11/16 02:34:33]

Why a boolean success callback?  In which circumstances can this fail?  Should
we be returning an error instead?

[jennyz, 2016/12/07 01:21:48]

Removed the boolean argument and pass error with chrome.runtime.lastError
instead.

+  };
 };