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. Dejará de estar disponible cuando se lance la solución de la Web abierta, lo que podría ocurrir en el cuarto trimestre de 2017.

Permisos

clipboard

Disponibilidad

Canal de desarrollo Solo para 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 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 admitidos.

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 y versiones posteriores

    Son los datos de la imagen codificados.

  • tipo

    ImageType

    Es el tipo de imagen que se pasa.

  • additionalItems

    AdditionalDataItem[] opcional

    Chrome 60 y versiones posteriores

    Son elementos de datos adicionales para describir los datos de imágenes. Se llama a la devolución de llamada con chrome.runtime.lastError establecido en el código de error si hay un error. Requiere permisos de 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. Se requieren permisos de 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