Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Navigator.clipboard — accès asynchrone au presse-papiers

Navigator.clipboard expose un objet Clipboard permettant de lire et d’écrire de façon asynchrone dans le presse-papiers système. Un contexte sécurisé est requis et l’accès est soumis aux restrictions du navigateur.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

navigator.clipboard
const text = await navigator.clipboard.readText();
await navigator.clipboard.writeText(text)

Navigator.clipboard, accessible via navigator.clipboard, est une propriété en lecture seule qui renvoie le même objet Clipboard à chaque lecture. Elle ne contient pas directement de texte : readText() renvoie une Promise contenant le texte, tandis que writeText(text) renvoie une Promise qui est résolue sans valeur après l’écriture. read() et write() traitent des données représentées par ClipboardItem.

Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs. Un contexte sécurisé et un document actif qui a le focus sont nécessaires. Les autorisations et les exigences d’activation par l’utilisateur dépendent du navigateur : déclenchez l’écriture directement lors d’un clic et gérez les rejets, notamment NotAllowedError. La détection d’une méthode ne garantit pas l’accès.

Contrairement à ClipboardEvent.clipboardData, associé aux événements de copie et de collage, cette interface est asynchrone. Le presse-papiers peut contenir des données sensibles ; ne le lisez que dans un but clairement défini et avertissez avant d’en remplacer le contenu.

Exemples

<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Navigator clipboard write</title></head>
<body>
  <button type="button">Copy sample text</button>
  <p role="status"></p>
  <script>
    const button = document.querySelector('button');
    const status = document.querySelector('[role="status"]');
    const clipboard = navigator.clipboard;
    const canAttemptWrite = window.isSecureContext &&
      typeof clipboard?.writeText === 'function';

    status.textContent = canAttemptWrite
      ? 'Click to request a clipboard write.'
      : 'Clipboard write is unavailable in this document.';
    button.disabled = !canAttemptWrite;
    console.log(status.textContent);

    button.addEventListener('click', async () => {
      try {
        await clipboard.writeText('CKTIS');
        status.textContent = 'Sample text copied.';
      } catch (error) {
        status.textContent = 'Clipboard write failed: ' + error.name;
      }
    });
  </script>
</body>
</html>

Résultat

Before interaction, the page reports whether a user-initiated clipboard write can be attempted. If it can, clicking the button reports either success or the browser's error name.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources