chrome.clipboard

Opis

Interfejs API chrome.clipboard umożliwia użytkownikom dostęp do danych w schowku. Jest to tymczasowe rozwiązanie dla aplikacji platformy ChromeOS, dopóki nie będzie dostępna alternatywa dla otwartej sieci. Zostanie wycofany, gdy będzie dostępne rozwiązanie dla otwartej sieci, co może nastąpić w IV kwartale 2017 r.

Uprawnienia

clipboard

Dostępność

Wersja deweloperska Tylko ChromeOS

Typy

AdditionalDataItem

Właściwości

  • dane

    tekst

    Treść dodatkowego elementu danych. Ciąg zwykłego tekstu, jeśli type to „textPlain”, lub ciąg znaczników, jeśli type to „textHtml”. Rozmiar danych nie może przekraczać 2 MB.

  • Typ dodatkowego elementu danych.

DataItemType

Typ wyliczeniowy

"textPlain"

"textHtml"

ImageType

Obsługiwane typy obrazów.

Typ wyliczeniowy

"png"

"jpeg"

Metody

setImageData()

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

Ustawia dane obrazu w schowku.

Parametry

  • imageData

    ArrayBuffer

    Chrome 60 lub nowsza wersja

    Zakodowane dane obrazu.

  • typ

    ImageType

    Typ przekazywanego obrazu.

  • additionalItems

    AdditionalDataItem[] opcjonalny

    Chrome 60 lub nowsza wersja

    Dodatkowe elementy danych do opisu danych obrazu. Jeśli wystąpi błąd, wywołanie zwrotne jest wywoływane z parametrem chrome.runtime.lastError ustawionym na kod błędu. Wymaga uprawnień clipboard i clipboardWrite.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onClipboardDataChanged

Chrome 56 lub nowsza wersja 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Uruchamiane, gdy zmieniają się dane w schowku. Wymaga uprawnień clipboard i clipboardRead, aby dodać detektor do zdarzenia chrome.clipboard.onClipboardDataChanged. Po wywołaniu tego zdarzenia dane ze schowka są dostępne po wywołaniu funkcji document.execCommand('paste').

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void