Descripción
La API de chrome.clipboard
se proporciona para permitir que los usuarios accedan a los datos del portapapeles. Esta es una solución temporal para las apps de la plataforma chromeos hasta que esté disponible la alternativa de Open Web. Dejará de estar disponible una vez que esté disponible la solución web abierta, lo que podría suceder en el cuarto trimestre de 2017.
Permisos
clipboard
Disponibilidad
Tipos
AdditionalDataItem
Propiedades
-
datos
cadena
Contenido del elemento de datos adicionales. Es la cadena de texto sin formato si
type
es "textPlain" o la cadena de lenguaje de marcado sitype
es "textHtml". Los datos no pueden superar los 2 MB. -
tipo
Es el tipo del elemento de datos adicionales.
DataItemType
Enum
"textPlain"
"textHtml"
ImageType
Tipos de imágenes compatibles.
Enum
"png"
Métodos
setImageData()
chrome.clipboard.setImageData(
imageData: ArrayBuffer,
type: ImageType,
additionalItems?: AdditionalDataItem[],
callback?: function,
)
Configura los datos de la imagen en el portapapeles.
Parámetros
-
imageData
ArrayBuffer
Chrome 60 y versiones posterioresLos datos de la imagen codificados.
-
tipo
Es el tipo de imagen que se pasa.
-
additionalItems
AdditionalDataItem[] opcional
Chrome 60 y versiones posterioresElementos de datos adicionales para describir los datos de imágenes. Si hay un error, se llama a la devolución de llamada con
chrome.runtime.lastError
establecido en código de error. Requiere permisos de portapapeles y portapapeles. -
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Devuelve
-
Promise<void>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
Eventos
onClipboardDataChanged
chrome.clipboard.onClipboardDataChanged.addListener(
callback: function,
)
Se activa cuando cambian los datos del portapapeles. Requiere permisos de portapapeles y portapapeles para agregar un objeto de escucha al evento chrome.clipboard.onClipboardDataChanged. Después de que se activa este evento, los datos del portapapeles están disponibles llamando a document.execCommand('paste').
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:() => void