Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Clipboard.writeText()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2020.
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
var promesse = navigator.clipboard.writeText(nouveauTexte);
Paramètres
nouveauTexte-
La
Stringdevant ê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 |
|---|
| Clipboard API and events # dom-clipboard-writetext |
Compatibilité des navigateurs
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Aider à améliorer MDN
Cette page a été modifiée le par les contributeur·ice·s du MDN.