chrome.clipboard

Description

The chrome.clipboard API is provided to allow users to access data of the clipboard. This is a temporary solution for chromeos platform apps until open-web alternative is available. It will be deprecated once open-web solution is available, which could be in 2017 Q4.

Permissions

clipboard

Availability

Dev channel ChromeOS only

Types

AdditionalDataItem

Properties

  • data

    string

    Content of the additional data item. Either the plain text string if type is "textPlain" or markup string if type is "textHtml". The data can not exceed 2MB.

  • Type of the additional data item.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Supported image types.

Enum

"png"

"jpeg"

Methods

setImageData()

Promise Chrome 57+ 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Sets image data to clipboard.

Parameters

  • imageData

    ArrayBuffer

    Chrome 60+

    The encoded image data.

  • type

    ImageType

    The type of image being passed.

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60+

    Additional data items for describing image data. The callback is called with chrome.runtime.lastError set to error code if there is an error. Requires clipboard and clipboardWrite permissions.

  • callback

    function optional

    The callback parameter looks like: 

    () => void

Returns

  • Promise<void>

    Chrome 91+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

Events

onClipboardDataChanged

Chrome 56+ 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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').

Parameters

  • callback

    function

    The callback parameter looks like: 

    () => void