CKTIS / JavaScript
Clipboard.writeText — écrire du texte dans le presse-papiers
Clipboard.writeText écrit du texte brut dans le presse-papiers du système. L’opération est asynchrone et nécessite un contexte sécurisé ainsi que l’autorisation du navigateur pour écrire.
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
await navigator.clipboard.writeText(text);Clipboard.writeText, appelée sous la forme navigator.clipboard.writeText(text), remplace le contenu du presse-papiers par du texte brut, et non du HTML. Elle renvoie une Promise qui est résolue avec undefined une fois l’écriture effectuée.
Un contexte sécurisé et un document actif ayant le focus sont requis. Appelez la méthode directement à la suite d’un clic ; l’activation de l’utilisateur ne garantit pas l’autorisation. Un refus peut entraîner le rejet de la promesse avec NotAllowedError.
Utilisez await et try...catch ; n’indiquez la réussite qu’après la résolution de la promesse. Vérifiez la disponibilité de l’API dans le navigateur cible : Node 24 dans le dépôt ne permet pas d’établir la prise en charge dans les navigateurs.
Exemples
const button = document.createElement('button');
button.type = 'button';
button.textContent = 'Copy CKTIS';
const status = document.createElement('p');
status.setAttribute('role', 'status');
document.body.append(button, status);
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.writeText !== 'function') {
status.textContent = 'Unavailable';
return;
}
try {
await navigator.clipboard.writeText('CKTIS');
status.textContent = 'Copied: CKTIS';
} catch (error) {
status.textContent = `Copy failed: ${error.name}`;
}
});Résultat
Copied: 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.