chrome.clipboard

.

Opis

Interfejs API chrome.clipboard umożliwia użytkownikom dostęp do danych ze schowka. Jest to tymczasowe rozwiązanie dla aplikacji platformy ChromeOS, dopóki nie pojawi się alternatywa dla otwartej sieci. Zostanie ono wycofane po udostępnieniu rozwiązania typu open web, 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. Jeśli type ma wartość „textplain” lub ciągu znacznika, 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()

Obietnica Chrome w wersji 57 lub nowszej 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Ustawia dane obrazu w schowku.

Parametry

  • Dane_obrazów

    SlateBuffer

    Chrome w wersji 60 lub nowszej .

    Zakodowane dane obrazu.

  • typ

    ImageType

    Typ przekazywanego obrazu.

  • additionalItems

    AdditionalDataItem[] opcjonalny

    Chrome w wersji 60 lub nowszej .

    Dodatkowe elementy danych do opisywania danych zdjęć. W przypadku wystąpienia błędu wywołanie zwrotne jest wywoływane z kodem błędu chrome.runtime.lastError. Wymaga uprawnień do schowka i schowkaWrite.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onClipboardDataChanged

Chrome w wersji 56 lub nowszej .
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Uruchamiane po zmianie danych schowka. Do dodawania detektora do zdarzenia chrome.clipboard.onClipboardDataChanged wymagane są uprawnienia schowka inescreadRead. Po uruchomieniu tego zdarzenia dane ze schowka będą dostępne po wywołaniu właściwości document.execCommand('paste').

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    () => void