chrome.clipboard

Descrição

A API chrome.clipboard é fornecida para permitir que os usuários acessem os dados da área de transferência. Essa é uma solução temporária para aplicativos da plataforma ChromeOS até que uma alternativa de web aberta esteja disponível. Ele será descontinuado quando a solução de Web aberta estiver disponível, o que pode estar em 2017 no quarto trimestre de 2017.

Permissões

clipboard

Disponibilidade

Canal Dev Somente no ChromeOS

Tipos

AdditionalDataItem

Propriedades

  • dados

    string

    Conteúdo do item de dados adicionais. A string de texto simples, se type for "textPlain" ou a string de marcação se type for "textHTML". Os dados não podem ultrapassar 2 MB.

  • digitar

    DataItemType

    Tipo do item de dados adicionais.

DataItemType

Tipo enumerado

ImageType

Tipos de imagem compatíveis.

Tipo enumerado

"png"

"jpeg"

Métodos

setImageData()

Promessa Chrome 57+ 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Define os dados da imagem para a área de transferência.

Parâmetros

  • imageData

    ArrayBuffer

    Chrome 60 ou mais recente

    Os dados da imagem codificada.

  • digitar

    ImageType

    O tipo de imagem sendo transmitida.

  • additionalItems

    AdditionalDataItem[] opcional

    Chrome 60 ou mais recente

    Itens de dados adicionais para descrever dados da imagem. O callback é chamado com chrome.runtime.lastError definido como código de erro, em caso de erro. Requer as permissões de área de transferência e de gravação da área de transferência.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onClipboardDataChanged

Chrome 56 ou mais recente 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Disparado quando os dados da área de transferência são alterados. Exige as permissões da área de transferência e da área de transferênciaRead para adicionar um listener ao evento chrome.clipboard.onClipboardDataChanged. Depois que o evento é disparado, os dados da área de transferência ficam disponíveis chamando document.execCommand('paste').

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    ()=>void