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 Clipboard availability in Clipboard pour plus de détails.

Syntaxe

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>".

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

Spécification Statut Commentaire
Clipboard API and events
La définition de 'writeText()' dans cette spécification.
Version de travail Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser