chrome.clipboard

Descrição

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

Permissões

clipboard

Disponibilidade

Canal de Desenvolvedor Somente ChromeOS

Tipos

AdditionalDataItem

Propriedades

  • dados

    string

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

  • Tipo do item de dados adicional.

DataItemType

Enumeração

"textPlain"

"textHTML"

ImageType

Tipos de imagem compatíveis.

Enumeração

"png"

"jpeg"

Métodos

setImageData()

Promessa Chrome 57 ou versão mais recente 
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

    Buffer de matriz

    Chrome 60 ou superior

    Os dados de imagem codificados.

  • tipo

    ImageType

    O tipo de imagem que está sendo transmitido.

  • additionalItems

    AdditionalDataItem[] opcional

    Chrome 60 ou superior

    Itens de dados adicionais para descrever dados de imagem. O callback será chamado com chrome.runtime.lastError definido para o código de erro se houver um erro. Requer as permissões da área de transferência e da área de transferência.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onClipboardDataChanged

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

Disparado quando os dados da área de transferência são alterados. Requer permissões de área de transferência e área de transferência para adicionar listener ao evento chrome.clipboard.onClipboardDataChanged. Após o acionamento desse evento, 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