chrome.clipboard

Opis

Dostępny jest interfejs chrome.clipboard API, który umożliwia użytkownikom dostęp do danych schowka. Jest to tymczasowe rozwiązanie dla aplikacji platformy ChromeOS, dopóki nie pojawi się alternatywa dla otwartych przeglądarek. Zostanie ona wycofana po udostępnieniu rozwiązania open-web, na przykład w IV kwartale 2017 r.

Uprawnienia

clipboard

Dostępność

Wersja deweloperska Tylko ChromeOS

Typy

AdditionalDataItem

Właściwości

  • dane

    string,

    Treść dodatkowego elementu danych. Jeśli type to „textplain”, albo ciąg znaczników, jeśli type ma wartość „texthtml”. Dane nie mogą być większe niż 2 MB.

  • Typ dodatkowego elementu danych.

DataItemType

Enum

ImageType

Obsługiwane typy obrazów.

Enum

Metody

setImageData()

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

Wstawia dane obrazu do schowka.

Parametry

  • imageData

    ArrayBuffer

    Chrome 60 i nowsze wersje

    Zakodowane dane obrazu.

  • typ

    ImageType

    Typ przekazywanego obrazu.

  • additionalItems

    AdditionalDataItem[] opcjonalny

    Chrome 60 i nowsze wersje

    Dodatkowe elementy danych do opisywania danych obrazu. Wywołanie zwrotne jest wywoływane z kodem chrome.runtime.lastError ustawionym na kod błędu w przypadku błędu. Wymaga uprawnień do korzystania z schowka i schowka.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

Wydarzenia

onClipboardDataChanged

Chrome 56 i nowsze wersje 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    ()=>void