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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
writeTextChrome Support complet 66Edge Aucun support NonFirefox Support complet 63
Notes
Support complet 63
Notes
Notes Writing to the clipboard is available without permission in secure contexts and browser extensions, but only from user-initiated event callbacks. Browser extensions with the "clipboardWrite" permission can write to the clipboard at any time.
IE Aucun support NonOpera Support complet 53Safari Aucun support NonWebView Android Support complet 66Chrome Android Support complet 66Firefox Android Support complet 63
Notes
Support complet 63
Notes
Notes Writing to the clipboard is available without permission in secure contexts and browser extensions, but only from user-initiated event callbacks. Browser extensions with the "clipboardWrite" permission can write to the clipboard at any time.
Opera Android Support complet 47Safari iOS Aucun support NonSamsung Internet Android Support complet 9.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.