Clipboard.writeText()

La méthode writeText() de l'interface Clipboard écrit le texte spécifié dans le presse-papiers du système.

Note : La spécification requiert que l'API Permissions soit utilisée pour obtenir la permission "clipboardWrite" avant d'écrire dans le presse-papiers. Cependant, les prérequis exacts varient de navigateur en navigateur, car c'est une API récente. Consultez la table de compatibilité et la section Disponibilité du presse-papiers sur la page Clipboard pour plus de détails.

Syntaxe

js
var promesse = navigator.clipboard.writeText(nouveauTexte);

Paramètres

nouveauTexte

La DOMString devant être écrite dans le presse-papiers.

Valeur de retour

Une Promise qui sera résolue une fois que le contenu du presse-papiers aura été mis à jour. La promesse est rejetée si le code appelant n'a pas la permission d'écrire dans le presse-papiers.

Exemple

Cet exemple définit le contenu du presse-papiers comme la chaîne "<presse-papiers vide>".

js
navigator.clipboard.writeText("<presse-papiers vide>").then(
  function () {
    /* presse-papiers modifié avec succès */
  },
  function () {
    /* échec de l’écriture dans le presse-papiers */
  },
);

Spécifications

Specification
Clipboard API and events
# dom-clipboard-writetext

Compatibilité des navigateurs

BCD tables only load in the browser