chrome.clipboard

Description

L'API chrome.clipboard permet aux utilisateurs d'accéder aux données du presse-papiers. Cette solution est temporaire pour les applications de la plate-forme chromeos jusqu'à ce qu'une alternative au Web ouvert soit disponible. Elle sera abandonnée une fois la solution Open Web disponible, qui pourrait se situer au 4e trimestre 2017.

Autorisations

clipboard

Garantie de disponibilité

Version en développement ChromeOS uniquement

Types

AdditionalDataItem

Propriétés

  • data

    chaîne

    Contenu de l'élément de données supplémentaire. La chaîne de texte brut si type correspond à "textPlain" ou la chaîne de balisage si type correspond à "textHTML". Les données ne doivent pas dépasser 2 Mo.

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

DataItemType

Enum

"textPlain"

ImageType

Types d'images compatibles.

Enum

"png"

"jpeg"

Méthodes

setImageData()

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

Définit les données de l'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 transmise.

  • additionalItems

    AdditionalDataItem[] facultatifs

    Chrome 60 ou version ultérieure

    Éléments de données supplémentaires permettant de décrire des 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 d'écriture dans le presse-papiers et dans le presse-papiers.

  • rappel

    fonction facultative

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

    ()=>void

Renvoie

  • Promise<void>

    Chrome 91 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et 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 du presse-papiers et du presse-papiers 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

  • rappel

    function

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

    ()=>void