chrome.clipboard

Description

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

Autorisations

clipboard

Disponibilité

Canal de développement ChromeOS uniquement

Types

AdditionalDataItem

Propriétés

  • données

    chaîne

    Contenu de l'élément de données supplémentaires. Chaîne de texte brut si type est "textPlain", ou chaîne de balisage si type est "textHtml". Les données ne doivent pas dépasser 2 Mo.

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

DataItemType

Énumération

"textPlain"

"textHtml"

ImageType

Types d'images acceptés.

É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 et versions ultérieures

    Données d'image encodées.

  • type

    ImageType

    Type d'image transmise.

  • additionalItems

    AdditionalDataItem[] facultatif

    Chrome 60 et versions ultérieures

    É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 et versions ultérieures

    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 et versions ultérieures 
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