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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
writeText

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.