WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ClipboardItem — ein Clipboard-Element mit MIME-Repräsentationen

ClipboardItem beschreibt ein einzelnes Element der Zwischenablage, das mehrere MIME-Repräsentationen haben kann. Der Konstruktor bereitet die Daten vor; er schreibt sie nicht selbst in die Systemzwischenablage.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

ClipboardItem gehört zu den Web APIs, nicht zu ECMAScript. Ein Objekt kann verschiedene Repräsentationen desselben Inhalts enthalten. Der Konstruktor erwartet eine nicht leere Zuordnung von MIME-Typen zu Blob-Werten, Zeichenfolgen oder Promises solcher Werte; eine leere Zuordnung löst einen TypeError aus.

types stellt die Repräsentationstypen bereit, und getType(type) gibt ein Promise<Blob> zurück; fehlt eine Repräsentation, wird das Promise mit NotFoundError abgelehnt. Das optionale presentationStyle akzeptiert "unspecified" (Standardwert), "inline" oder "attachment". Die statische Methode ClipboardItem.supports(type) prüft die Formatunterstützung, nicht die Berechtigungen.

Erst navigator.clipboard.write([item]) schreibt die Daten; navigator.clipboard.read() liest Elemente aus. Der Zugriff auf die Zwischenablage unterliegt Einschränkungen durch Berechtigungen, Nutzeraktivierung und Fokus. Die Schnittstelle erfordert einen sicheren Window-Kontext. Prüfe die Verfügbarkeit der verwendeten Methoden; die Spezifikation ist ein W3C-Entwurf, und Node 24 belegt keine Browserunterstützung.

Beispiele

<!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>

Ergebnis

ClipboardItem unavailable

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen