Clipboard.writeText()
Baseline
Widely available
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
DOMStringdevant ê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
| Specification |
|---|
| Clipboard API and events # dom-clipboard-writetext |
Compatibilité des navigateurs
Chargement…