chrome.clipboard

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 de ChromeOS hasta que esté disponible una alternativa de la Web abierta. Se dejará de usar una vez que esté disponible la solución de la Web abierta, lo que podría ocurrir en el cuarto trimestre de 2017.

Permisos

clipboard

Disponibilidad

Canal para desarrolladores Solo en ChromeOS

Tipos

AdditionalDataItem

Propiedades

  • datos

    string

    Es el contenido del elemento de datos adicional. Es la cadena de texto sin formato si type es "textPlain" o la cadena de lenguaje de marcado si type es "textHtml". Los datos no pueden superar los 2 MB.

  • Es el tipo del elemento de datos adicional.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Tipos de imágenes compatibles.

Enum

"png"

"jpeg"

Métodos

setImageData()

Promise Chrome 57 y versiones posteriores 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

Establece los datos de la imagen en el portapapeles.

Parámetros

  • imageData

    ArrayBuffer

    Chrome 60 o versiones posteriores

    Son los datos de la imagen codificada.

  • tipo

    ImageType

    Es el tipo de imagen que se pasa.

  • additionalItems

    AdditionalDataItem[] opcional

    Chrome 60 o versiones posteriores

    Son elementos de datos adicionales para describir los datos de imágenes. Si se produce un error, se llama a la devolución de llamada con chrome.runtime.lastError establecido en el código de error. Requiere los permisos clipboard y clipboardWrite.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

Eventos

onClipboardDataChanged

Chrome 56 y versiones posteriores 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Se activa cuando cambian los datos del portapapeles. Requiere los permisos clipboard y clipboardRead 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

    función

    El parámetro callback se ve de la siguiente manera: 

    () => void