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 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

Canal para desarrolladores Solo para ChromeOS

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 si type es "textHtml". Los datos no pueden superar los 2 MB.

  • Es el tipo del elemento de datos adicionales.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Tipos de imágenes compatibles.

Enum

"png"

Métodos

setImageData()

Promesa Chrome 57 y versiones posteriores 
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 posteriores

    Los datos de la imagen codificados.

  • tipo

    ImageType

    Es el tipo de imagen que se pasa.

  • additionalItems

    AdditionalDataItem[] opcional

    Chrome 60 y versiones posteriores

    Elementos 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 posteriores

    Las promesas solo son compatibles con 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 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