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
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 setype
for "textHTML". Os dados não podem ultrapassar 2 MB. -
digitar
Tipo do item de dados adicionais.
DataItemType
Tipo enumerado
ImageType
Tipos de imagem compatíveis.
Tipo enumerado
"png"
"jpeg"
Métodos
setImageData()
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 recenteOs dados da imagem codificada.
-
digitar
O tipo de imagem sendo transmitida.
-
additionalItems
AdditionalDataItem[] opcional
Chrome 60 ou mais recenteItens 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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
Eventos
onClipboardDataChanged
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