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

CKTIS / JavaScript

Clipboard — accès asynchrone au presse-papiers

Clipboard donne accès au presse-papiers du système via navigator.clipboard ; les opérations sont asynchrones et soumises à des restrictions de sécurité.

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.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>

Clipboard, accessible via navigator.clipboard, est une interface de Web API, et non d’ECMAScript. readText() renvoie du texte, writeText() écrit du texte ; read() et write() manipulent des objets ClipboardItem. Ces méthodes renvoient des promesses.

Un contexte sécurisé et le focus du document sont nécessaires. Les permissions et l’activation de l’utilisateur peuvent limiter l’accès ; un clic ne garantit pas la réussite. Gérez les rejets, notamment NotAllowedError. Vérifiez la disponibilité des fonctionnalités ; le brouillon du W3C ne garantit pas la prise en charge par les navigateurs, pas plus que Node 24 ne la prouve.

Cela diffère des événements synchrones copy, cut et paste utilisant event.clipboardData. Le presse-papiers peut contenir des secrets : évitez de le lire sans demande. L’exemple ne remplace le contenu du presse-papiers qu’après un clic.

Exemples

const button = document.createElement('button');
const status = document.createElement('p');
button.textContent = 'Copy CKTIS';
status.setAttribute('role', 'status');
document.body.append(button, status);

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.writeText !== 'function') {
    status.textContent = 'Clipboard unavailable';
    return;
  }

  button.disabled = true;
  try {
    await navigator.clipboard.writeText('CKTIS');
    status.textContent = 'Copied: CKTIS';
  } catch (error) {
    status.textContent = `Copy failed: ${error.name}`;
  } finally {
    button.disabled = false;
  }
});

Résultat

On an allowed, successful click: Copied: CKTIS
Clipboard text: CKTIS

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