Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ClipboardItem — stavka međuspremnika s MIME prikazima

ClipboardItem opisuje jednu stavku međuspremnika koja može imati nekoliko MIME prikaza. Konstruktor priprema podatke, ali ih sam ne zapisuje u međuspremnik sustava.

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

Sintaksa

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

ClipboardItem pripada Web API-jima, a ne ECMAScriptu. Jedan objekt može sadržavati različite prikaze istog sadržaja. Konstruktor prihvaća nepraznu mapu MIME tipova na vrijednosti Blob, nizove ili obećanja tih vrijednosti; prazna mapa izaziva TypeError.

types izlaže tipove prikaza, a getType(type) vraća Promise<Blob>; ako prikaz nedostaje, obećanje se odbija s NotFoundError. Neobavezno svojstvo presentationStyle prihvaća "unspecified" (zadano), "inline" ili "attachment". Statička metoda ClipboardItem.supports(type) provjerava podržanost formata, a ne dopuštenja.

Podatke zapisuje tek navigator.clipboard.write([item]); navigator.clipboard.read() čita stavke. Pristup međuspremniku podliježe ograničenjima dopuštenja, korisničke aktivacije i fokusa. Sučelje zahtijeva siguran kontekst Window. Provjerite dostupnost metoda koje upotrebljavate; specifikacija je nacrt W3C-a, a Node 24 ne potvrđuje podršku u preglednicima.

Primjeri

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

Rezultat

ClipboardItem unavailable

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori