chrome.clipboard

Descrizione

L'API chrome.clipboard è 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 una soluzione web aperto, il che potrebbe avvenire nel quarto trimestre del 2017.

Autorizzazioni

clipboard

Disponibilità

Canale Dev Solo ChromeOS

Tipi

AdditionalDataItem

Proprietà

  • dati

    stringa

    Contenuti dell'elemento di dati aggiuntivo. La stringa di testo normale se type è "textPlain" o stringa di markup se type è "texthtml". Le dimensioni dei dati non possono essere superiori a 2 MB.

  • Tipo dell'elemento di dati aggiuntivo.

DataItemType

Enum

"textPlain"

"texthtml"

ImageType

Tipi di immagini supportati.

Enum

"png"

"jpeg"

Metodi

setImageData()

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

Imposta i dati dell'immagine negli appunti.

Parametri

  • imageData

    ArrayBuffer

    Chrome 60 e versioni successive .

    I dati immagine codificati.

  • tipo

    ImageType

    Il tipo di immagine che viene passato.

  • additionalItems

    AdditionalDataItem[] facoltativo

    Chrome 60 e versioni successive .

    Elementi di dati aggiuntivi per descrivere i dati dell'immagine. Il callback viene chiamato con chrome.runtime.lastError impostato sul codice di errore in caso di errore. Sono necessarie le autorizzazioni Appunti e AppuntiWrite.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

    Le promesse 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. Sono necessarie le autorizzazioni Appunti e Appunti 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