chrome.clipboard

Opis

Interfejs chrome.clipboard API umożliwia użytkownikom dostęp do danych schowka. Jest to tymczasowe rozwiązanie dla aplikacji na platformę ChromeOS, dopóki nie będzie dostępna alternatywa w otwartej sieci. Zostanie wycofana, 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

    ciąg znaków

    Zawartość dodatkowego elementu danych. Ciąg zwykłego tekstu, jeśli type ma wartość „textPlain”, lub ciąg znaczników, jeśli type ma wartość „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 lub nowszy 
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

    Zakodowane dane obrazu.

  • typ

    ImageType

    Typ przekazywanego obrazu.

  • additionalItems

    AdditionalDataItem[] opcjonalnie

    Chrome 60 lub nowsza

    Dodatkowe elementy danych opisujące dane obrazu. Jeśli wystąpi błąd, wywołanie zwrotne zostanie wywołane z parametrem chrome.runtime.lastError ustawionym na kod błędu. Wymaga uprawnień clipboard i clipboardWrite.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onClipboardDataChanged

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

Uruchamiane, gdy dane w schowku się zmienią. Wymaga uprawnień clipboard i clipboardRead do dodawania detektora do zdarzenia chrome.clipboard.onClipboardDataChanged. Po uruchomieniu tego zdarzenia dane ze schowka są dostępne po wywołaniu polecenia document.execCommand('paste').

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void