CKTIS / JavaScript
Clipboard.write — écriture asynchrone dans le presse-papiers
Clipboard.write écrit des objets ClipboardItem dans le presse-papiers système. La méthode accepte plusieurs représentations MIME, mais nécessite un contexte sécurisé et l’autorisation 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
await navigator.clipboard.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);Clipboard.write, appelée sous la forme navigator.clipboard.write(items), accepte des objets ClipboardItem. Un élément peut contenir plusieurs représentations MIME du même contenu. writeText(text) est plus simple pour du texte seul. La promesse renvoyée est résolue avec undefined une fois l’écriture effectuée ; un accès refusé peut provoquer NotAllowedError.
Il s’agit d’une API Web, et non d’une partie d’ECMAScript ; Node 24 ne permet pas d’établir la prise en charge par les navigateurs. Vérifiez la disponibilité de l’API et testez les navigateurs visés. Utilisez un contexte sécurisé : HTTPS ou une origine locale digne de confiance, telle que localhost. HTTPS seul ne garantit pas un contexte sécurisé si la page est intégrée sous un ancêtre non sécurisé ; vérifiez window.isSecureContext.
Lancez l’écriture directement à la suite d’un clic dans un document qui a le focus et gérez les erreurs ; les règles d’autorisation varient selon le navigateur. Ne confondez pas plusieurs représentations avec plusieurs éléments : la plateforme peut ne conserver que le premier élément. L’exemple remplace le contenu du presse-papiers après un clic volontaire de l’utilisateur.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Clipboard.write</title>
<button id="copy" type="button">Copy: Hello, clipboard!</button>
<output id="status" aria-live="polite"></output>
<script>
const button = document.querySelector('#copy');
const status = document.querySelector('#status');
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.write !== 'function' ||
typeof ClipboardItem !== 'function') {
status.textContent = 'Unavailable';
return;
}
try {
const blob = new Blob(['Hello, clipboard!'], { type: 'text/plain' });
const item = new ClipboardItem({ 'text/plain': blob });
await navigator.clipboard.write([item]);
status.textContent = 'Copied';
} catch (error) {
status.textContent = `Failed: ${error.name}`;
}
});
</script>Résultat
The status is initially empty. After the user clicks the button, it displays `Copied` only if the clipboard write succeeds. If the context is insecure or the required API is unavailable, it displays `Unavailable`. If an error occurs while preparing or writing the clipboard item, it displays `Failed: ` followed by the 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.