Clipboard.writeText()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 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 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

Specification
Clipboard API and events # dom-clipboard-writetext