chrome.clipboard

Descrizione

L'API chrome.clipboard viene fornita per consentire agli utenti di accedere ai dati degli appunti. Questa è una soluzione temporanea per le app della piattaforma chromeos fino a quando non sarà disponibile un'alternativa open-web. Verrà ritirato una volta che la soluzione open-web sarà disponibile, probabilmente nel quarto trimestre del 2017.

Autorizzazioni

clipboard

Disponibilità

Canale Dev Solo ChromeOS

Tipi

AdditionalDataItem

Proprietà

  • dati

    stringa

    Contenuti dell'elemento di dati aggiuntivo. Può essere 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 di dati aggiuntivi.

DataItemType

Enum

"textPlain"

ImageType

Tipi di immagini supportati.

Enum

"png"

"jpeg"

Metodi

setImageData()

Promessa 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 dell'immagine codificati.

  • tipo

    ImageType

    Il tipo di immagine da trasmettere.

  • additionalItems

    AdditionalDataItem[] facoltativo

    Chrome 60 e versioni successive

    Elementi di dati aggiuntivi per descrivere i dati di immagine. Il callback viene chiamato con chrome.runtime.lastError impostato sul codice di errore in caso di errore. Richiede le autorizzazioni di Appunti e Scrittura per Appunti.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

Eventi

onClipboardDataChanged

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

Attivato quando vengono modificati i dati degli appunti. Richiede le autorizzazioni Appunti e Appunti Read per aggiungere 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