Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ClipboardItem — položka schránky s reprezentacemi MIME

ClipboardItem popisuje jednu položku schránky, která může mít několik reprezentací MIME. Konstruktor připraví data, ale sám je do systémové schránky nezapíše.

Verze: 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 patří do Web APIs, nikoli do ECMAScriptu. Jeden objekt může obsahovat různé reprezentace stejného obsahu. Konstruktor přijímá neprázdnou mapu typů MIME na hodnoty Blob, řetězce nebo přísliby těchto hodnot; prázdná mapa vyvolá TypeError.

types zpřístupňuje typy reprezentací a getType(type) vrací Promise<Blob>; pokud reprezentace chybí, příslib je zamítnut s NotFoundError. Volitelná vlastnost presentationStyle přijímá "unspecified" (výchozí hodnota), "inline" nebo "attachment". Statická metoda ClipboardItem.supports(type) ověřuje podporu formátu, nikoli oprávnění.

Data zapíše až navigator.clipboard.write([item]); navigator.clipboard.read() načítá položky. Přístup ke schránce podléhá omezením oprávnění, aktivace uživatelem a fokusu. Rozhraní vyžaduje zabezpečený kontext Window. Ověřte dostupnost používaných metod; specifikace je návrhem W3C a Node 24 nepotvrzuje podporu v prohlížečích.

Příklady

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

Výsledek

ClipboardItem unavailable

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje