chrome.clipboard

Descrizione

L'API chrome.clipboard viene fornita per consentire agli utenti di accedere ai dati degli appunti. Si tratta di una soluzione temporanea per le app della piattaforma ChromeOS fino a quando non sarà disponibile un'alternativa open web. Verrà ritirata non appena sarà disponibile la soluzione per l'open web, probabilmente nel quarto trimestre del 2017.

Autorizzazioni

clipboard

Disponibilità

Canale Dev Solo ChromeOS

Tipi

AdditionalDataItem

Proprietà

  • dati

    stringa

    Contenuto dell'elemento dati aggiuntivo. La stringa di testo normale se type è "textPlain" o la stringa di markup se type è "textHtml". I dati non possono superare i 2 MB.

  • Il tipo di elemento dati aggiuntivo.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Tipi di immagini supportati.

Enum

"png"

"jpeg"

Metodi

setImageData()

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

Imposta i dati dell'immagine negli appunti.

Parametri

  • imageData

    ArrayBuffer

    Chrome 60+

    I dati dell'immagine codificati.

  • tipo

    ImageType

    Il tipo di immagine che viene trasmessa.

  • additionalItems

    AdditionalDataItem[] facoltativo

    Chrome 60+

    Elementi dati aggiuntivi per descrivere i dati delle immagini. In caso di errore, il callback viene chiamato con chrome.runtime.lastError impostato sul codice di errore. Richiede le autorizzazioni clipboard e clipboardWrite.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onClipboardDataChanged

Chrome 56 e versioni successive 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Attivato quando i dati degli appunti cambiano. Richiede le autorizzazioni clipboard e clipboardRead per aggiungere un listener all'evento chrome.clipboard.onClipboardDataChanged. Dopo l'attivazione di questo evento, i dati degli appunti sono disponibili chiamando document.execCommand('paste').

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void