chrome.clipboard

Описание

chrome.clipboard API позволяет пользователям получать доступ к данным буфера обмена. Это временное решение для приложений платформы ChromeOS, пока не станет доступна альтернатива для открытого интернета. Поддержка этого решения будет прекращена, как только станет доступно решение для открытого интернета (ориентировочно в IV квартале 2017 г.).

Разрешения

clipboard

Доступность

Канал для разработчиков Только для ChromeOS

Типы

AdditionalDataItem

Свойства

  • делал.

    string

    Контент дополнительного элемента данных. Строка обычного текста, если type имеет значение textPlain, или строка разметки, если type имеет значение textHtml. Размер данных не должен превышать 2 МБ.

  • тип

    DataItemType

    Тип дополнительного элемента данных.

DataItemType

Перечисление

"textPlain"

"textHtml"

ImageType

Поддерживаемые форматы изображений.

Перечисление

"png"

"jpeg"

Методы

setImageData()

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

Копирует данные изображения в буфер обмена.

Параметры

  • imageData

    ArrayBuffer

    Chrome 60 и более поздних версий;

    Закодированные данные изображения.

  • тип

    ImageType

    Тип передаваемого изображения.

  • additionalItems

    AdditionalDataItem[] необязательный

    Chrome 60 и более поздних версий;

    Дополнительные элементы данных для описания данных изображения. Если возникает ошибка, обратный вызов осуществляется с кодом ошибки, заданным в chrome.runtime.lastError. Требуются разрешения clipboard и clipboardWrite.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onClipboardDataChanged

Chrome 56 и более поздних версий; 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Срабатывает при изменении данных в буфере обмена. Для добавления прослушивателя к событию chrome.clipboard.onClipboardDataChanged требуются разрешения clipboard и clipboardRead. После активации этого события данные буфера обмена становятся доступны при вызове document.execCommand('paste').

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    () => void