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.