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 finché non sarà disponibile un'alternativa per il web aperto. Verrà ritirato una volta disponibile la soluzione open web, che potrebbe essere nel quarto trimestre del 2017.

Autorizzazioni

clipboard

Disponibilità

Canale Dev Solo ChromeOS

Tipi

AdditionalDataItem

Proprietà

  • dati

    stringa

    Contenuto dell'elemento di 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.

  • Tipo dell'elemento di dati aggiuntivo.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Tipi di immagini supportati.

Enum

"png"

"jpeg"

Metodi

setImageData()

Promise Chrome 57+ 
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 di dati aggiuntivi per descrivere i dati delle immagini. Se si verifica un errore, il callback viene chiamato con chrome.runtime.lastError impostato sul codice di errore. Richiede le autorizzazioni clipboard e clipboardWrite.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

Eventi

onClipboardDataChanged

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

Attivato quando cambiano i dati degli appunti. Richiede le autorizzazioni clipboard e clipboardRead per aggiungere il 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