chrome.clipboard

Description

L'API chrome.clipboard permet aux utilisateurs d'accéder aux données du presse-papiers. Il s'agit d'une solution temporaire pour les applications de la plate-forme ChromeOS, en attendant qu'une alternative Web ouverte soit disponible. Elle sera abandonnée dès qu'une solution Open Web sera disponible, ce qui pourrait être le cas au quatrième trimestre 2017.

Autorisations

clipboard

Disponibilité

Version en développement ChromeOS uniquement

Types

AdditionalDataItem

Propriétés

  • données

    chaîne

    Contenu de l'élément de données supplémentaire. Chaîne de texte brut si type est "textPlain" ou chaîne de balisage si type est "textHtml". La taille des données ne peut pas dépasser 2 Mo.

  • Type de l'élément de données supplémentaire.

DataItemType

Énumération

"textPlain"

"textHtml"

ImageType

Types d'images compatibles.

Énumération

"png"

"jpeg"

Méthodes

setImageData()

Promise Chrome 57 et versions ultérieures 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

Définit les données d'image dans le presse-papiers.

Paramètres

  • imageData

    ArrayBuffer

    Chrome 60 ou version ultérieure

    Données d'image encodées.

  • type

    ImageType

    Type d'image transmis.

  • additionalItems

    AdditionalDataItem[] facultatif

    Chrome 60 ou version ultérieure

    Éléments de données supplémentaires pour décrire les données d'image. Le rappel est appelé avec chrome.runtime.lastError défini sur le code d'erreur en cas d'erreur. Nécessite les autorisations "clipboard" et "clipboardWrite".

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onClipboardDataChanged

Chrome 56 ou version ultérieure 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Déclenché lorsque les données du presse-papiers changent. Nécessite les autorisations "clipboard" et "clipboardRead" pour ajouter un écouteur à l'événement chrome.clipboard.onClipboardDataChanged. Une fois cet événement déclenché, les données du presse-papiers sont disponibles en appelant document.execCommand('paste').

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    () => void