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

CKTIS / JavaScript

ClipboardItem — un élément du presse-papiers avec des représentations MIME

ClipboardItem décrit un élément du presse-papiers qui peut avoir plusieurs représentations MIME. Son constructeur prépare les données ; il ne les écrit pas lui-même dans le presse-papiers du système.

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

new ClipboardItem(items, options)
item.types
item.getType(type) // Promise<Blob>
ClipboardItem.supports(type)

ClipboardItem fait partie des Web APIs, et non d’ECMAScript. Un objet peut contenir différentes représentations d’un même contenu. Son constructeur accepte une association non vide de types MIME à des valeurs Blob, à des chaînes de caractères ou à des promesses de ces valeurs ; une association vide déclenche TypeError.

types expose les types de représentation, et getType(type) renvoie un Promise<Blob> ; si une représentation est absente, la promesse est rejetée avec NotFoundError. La propriété facultative presentationStyle accepte "unspecified" (par défaut), "inline" ou "attachment". La méthode statique ClipboardItem.supports(type) vérifie la prise en charge du format, pas les autorisations.

Seul navigator.clipboard.write([item]) écrit les données ; navigator.clipboard.read() lit les éléments. L’accès au presse-papiers est soumis à des restrictions liées aux autorisations, à l’activation de l’utilisateur et au focus. L’interface nécessite un contexte Window sécurisé. Vérifiez la disponibilité des méthodes utilisées ; la spécification est un projet du W3C, et Node 24 ne prouve pas la prise en charge dans les navigateurs.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ClipboardItem MIME representation</title>
</head>
<body>
  <pre id="result" role="status"></pre>
  <script>
    async function showItem() {
      const result = document.querySelector('#result');
      if (typeof globalThis.ClipboardItem !== 'function') {
        result.textContent = 'ClipboardItem unavailable';
        return;
      }
      const type = 'text/plain';
      const item = new ClipboardItem({
        [type]: new Blob(['Hello'], { type })
      });
      const representation = await item.getType(type);
      result.textContent = item.types.join(', ') + '\n' + await representation.text();
    }
    showItem();
  </script>
</body>
</html>

Résultat

ClipboardItem unavailable

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