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 jusqu'à ce qu'une alternative Web ouverte soit disponible. Elle sera abandonnée une fois que la solution Web ouverte sera disponible, ce qui pourrait se produire au 4e trimestre 2017.

Autorisations

clipboard

Disponibilité

<ph type="x-smartling-placeholder"></ph> Version en 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 une 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émentaires.

DataItemType

Énumération

"textPlain"

"textHTML"

ImageType

Types d'images compatibles.

Énumération

"png"

"jpeg"

Méthodes

setImageData()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 57 ou ultérieure) 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

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

Paramètres

  • imageData

    ArrayBuffer

    Chrome (version 60 ou ultérieure)

    Données d'image encodées.

  • type

    ImageType

    Type d'image transmis.

  • additionalItems

    AdditionalDataItem[] facultatif

    Chrome (version 60 ou 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 "Presse-papiers" et "Écrire dans le presse-papiers".

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    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 (version 56 ou ultérieure) 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Déclenché lorsque les données du presse-papiers sont modifiées. Nécessite les autorisations "Presse-papiers" et "Presse-papiers" pour ajouter l'écouteur à l'événement chrome.clipboard.onClipboardDataChanged. Après le déclenchement de cet événement, les données du presse-papiers sont disponibles en appelant document.execCommand('paste').

Paramètres

  • rappel

    fonction

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

    () => void