Clipboard.write()

Baseline 2024

Newly available

Since June 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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() 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