хром.буфер обмена

Описание

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

Разрешения

clipboard

Доступность

Только для ChromeOS на канале разработки

Типы

AdditionalDataItem

Характеристики

  • данные

    нить

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

  • тип

    DataItemType

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

DataItemType

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

"textPlain"

"textHtml"

ImageType

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

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

"png"

"jpeg"

Методы

setImageData()

Обещание Chrome 57+
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

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

Параметры

  • imageData

    ArrayBuffer

    Хром 60+

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

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

  • дополнительные элементы

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

    Хром 60+

    Дополнительные элементы данных для описания данных изображения. Функция обратного вызова вызывается с chrome.runtime.lastError , устанавливаемым в качестве кода ошибки, если произошла ошибка. Требуются разрешения на доступ к буферу обмена и записи в буфер обмена.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

События

onClipboardDataChanged

Хром 56+
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    () => void