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

Описание

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

Разрешения

clipboard

Доступность

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

Типы

AdditionalDataItem

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

  • данные

    нить

    Содержимое дополнительного элемента данных. Либо обычная текстовая строка, если type — «textPlain», либо строка разметки, если type — «textHtml». Данные не могут превышать 2 МБ.

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

DataItemType

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

"textPlain"

"текстHtml"

ImageType

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

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

"ПНГ"

"Джпег"

Методы

setImageData()

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

Устанавливает данные изображения в буфер обмена.

Параметры

  • данные изображения

    МассивБуфер

    Хром 60+

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

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

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

    ДополнительныйЭлементДанных [] необязательно

    Хром 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