Clipboard.write()

La methode write() de Clipboard écrie des données arbitraire, comme des images, vers le presse-papier. Elle peut être utilisé pour implémenter une fonctionalité de copier coller.

Avant de pouvoir écrire dans le presse-papier, vous devez utiliser Permissions API pour avoir l'autorisation "clipboard-write".

Note : Les API Presse-papiers (clipboard) asynchrones sont toujours en cours d'implémentation. Consultez le tableau de compatibilité et la section Disponibilité du presse-papiers sur la page Clipboard pour plus d'informations.

Syntaxe

js
var promise = navigator.clipboard.write(dataTransfer);

Paramètres

dataTransfer

Un objet DataTransfer contenant les données à écrire dans le presse-papier.

Return value

Une Promise qui sera résolut quand les données seront écrite dans le presse papier. Cette promesse est rejetée si l'accés au presse-papier échoue.

Exemple

Cette fonction d'exemple remplace l'actuel contenu du presse-papier par le texte spécifié en paramètre.

js
function setClipboard(text) {
  let data = new DataTransfer();

  data.items.add(text, "text/plain");
  navigator.clipboard.write(data).then(
    function () {
      /* success */
    },
    function () {
      /* failure */
    },
  );
}

Le code commence par la creation d'un nouveau objet DataTransfer dans lequel le texte est placé pour être envoyé au presse-papier. DataTransferItemList.add() (en-US) est appelé pour ajouté le texte à DataTransfer, ensuite write() est appelé, en spécifiant une function d'accomplissement et une fonction d'erreur.

Spécifications

Specification
Clipboard API and events
# dom-clipboard-write

Compatibilité des navigateurs

BCD tables only load in the browser