Aller au contenu
FrAIFlow

Solutions / Navigateur & Appareil

Le bouton Copier fonctionne en local, mais pas sur votre site

Votre bouton Copier fonctionne sur localhost, puis échoue sur le site déployé. Déterminez d’abord si l’API Clipboard est absente ou si une écriture est refusée. Ces deux échecs n’appellent pas la même correction.

Repérer l’étape de l’échec
Illustration explicative fondée sur l’exemple conservé, et non capture d’application.

Récupérez le texte sans affaiblir la sécurité du navigateur

Si vous souhaitez seulement copier un résultat, cliquez dans le texte visible, sélectionnez-le et utilisez la commande Copier du système. Sur téléphone, appuyez longuement sur le texte pour faire apparaître les poignées de sélection. Si la page cache le résultat derrière un bouton Copier défectueux, c’est un problème d’ergonomie à corriger par le site. N’installez pas d’extension et ne désactivez pas les restrictions de sécurité simplement pour copier un court texte.

Si vous gérez le site, reproduisez le problème sur la page déployée. Vérifiez que l’adresse commence par HTTPS, que la page a le focus et qu’elle n’est pas intégrée dans un autre site. Un bouton fonctionnel sur localhost est utile pendant le développement, mais ne prouve pas que l’origine déployée dispose des mêmes autorisations.

Vérifiez la page déployée, pas seulement localhost

Un signalement public de 2018 confirmait que le passage à HTTPS rendait de nouveau disponible l’objet clipboard. Localhost peut masquer ce problème, car une connexion HTTP de boucle locale peut être considérée comme digne de confiance. Cette exception ne rend pas sécurisé un site HTTP ordinaire.

console.table({
  secure: window.isSecureContext,
  exposed: Boolean(navigator.clipboard),
  active: navigator.userActivation?.isActive
});

Le test Chromium isolé conservé comparait le HTTP de boucle locale à un nom d’hôte de test dirigé vers cette boucle locale. Il mesurait uniquement la disponibilité de l’API. Aucun contenu du presse-papiers n’a été lu ou écrit et aucune autorisation n’a été accordée. Si la page déployée n’est pas sécurisée, corrigez sa desserte HTTPS au lieu de demander aux visiteurs de désactiver les protections.

Associer l’action au clic
Illustration explicative fondée sur l’exemple conservé, et non capture d’application.

Déclenchez l’écriture dans le presse-papiers pendant le clic

HTTPS ne garantit pas à lui seul l’autorisation. Un signalement WebKit montrait un échec d’écriture dans Safari après qu’un gestionnaire de clic avait attendu un fetch. L’exemple corrigé lançait l’écriture pendant le clic et fournissait les données de ClipboardItem sous forme de promesse. Cela ne prouve pas que toute opération asynchrone échoue dans tous les navigateurs.

Cet exemple minimal garde le texte visible, déclenche l’écriture directement à partir d’un vrai clic et affiche une consigne de copie manuelle en cas d’échec. Enregistrez-le dans une page de test servie depuis une origine sécurisée autorisée. Il ne demande pas de lire le presse-papiers et n’envoie le texte nulle part. Dans votre application, remplacez la valeur d’exemple du textarea par le résultat déjà préparé.

<textarea id="copy-source" readonly aria-label="Text to copy">Your finished result</textarea>
<button id="copy-button" type="button">Copy result</button>
<p id="copy-status" role="status"></p>
<script>
const source = document.getElementById("copy-source");
const status = document.getElementById("copy-status");
document.getElementById("copy-button").addEventListener("click", async () => {
  try {
    if (!window.isSecureContext || !navigator.clipboard) {
      throw new Error("Clipboard unavailable");
    }
    await navigator.clipboard.writeText(source.value);
    status.textContent = "Copied. Paste it where you need it.";
  } catch {
    source.focus();
    source.select();
    status.textContent = "Automatic copy failed. Use your device's Copy command on the selected text.";
  }
});
</script>

Il s’agit d’un conseil d’implémentation, pas de l’affirmation d’un nouveau test multinavigateur. Si le résultat nécessite une requête réseau, terminez-la avant d’activer Copier. N’annoncez pas une copie réussie simplement parce que le gestionnaire de clic s’est exécuté. Dans cet exemple, le succès n’est annoncé qu’une fois la promesse d’écriture résolue.

Vérifiez la copie et gardez une solution manuelle

Utilisez un court exemple non sensible comprenant un saut de ligne et une lettre accentuée. Cliquez sur Copier, collez dans un éditeur de texte brut et comparez la valeur entière. Testez aussi la solution manuelle. Si la copie automatique échoue uniquement dans une iframe, comparez la page ouverte directement à sa version intégrée et examinez les règles d’intégration avec le propriétaire du site. Ne supposez pas qu’une boîte d’autorisation ou un réglage du navigateur se comporte de façon identique dans tous les moteurs.

Gardez à l’esprit la portée du test d’origine ci-dessous : il établissait la disponibilité de l’API, pas la capacité de ce bouton à écrire dans tous les navigateurs. L’objectif pratique est d’offrir deux chemins utilisables : une copie réussie lorsque c’est autorisé, et un résultat visible et sélectionnable sinon.

Conservez le texte visible et sélectionnable. Une page intégrée peut être limitée par la Permissions Policy de son parent ; le focus du document, les réglages du navigateur et les règles de la plateforme comptent aussi. Les noms et comportements des autorisations de presse-papiers diffèrent selon les navigateurs. Consultez leur documentation plutôt que de transformer un résultat Chromium en garantie pour Safari ou Firefox.

Mesure : l’API Clipboard est disponible en HTTP de boucle locale, mais pas avec un nom d’hôte HTTP ordinaire de test.
Explication d’origine conservée.
Résultat enregistré d’un test synthétique sur une copie fonctionnelle sur localhost mais pas sur le site
Contrôles enregistrés de l’origine et de la disponibilité de l’API dans un Chromium isolé. Aucun contenu du presse-papiers n’a été lu ou écrit. Cette image présente le résultat du test, pas l’application de l’auteur du signalement. Ouvrir l’image de preuve en grand.

Sources et lectures complémentaires