Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ClipboardItem — element odložišča z predstavitvami MIME

ClipboardItem opisuje en element odložišča, ki ima lahko več predstavitev MIME. Konstruktor pripravi podatke, vendar jih sam ne zapiše v sistemsko odložišče.

Različica: 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 spada med Web APIs, ne med ECMAScript. En objekt lahko vsebuje različne predstavitve iste vsebine. Konstruktor sprejme neprazno preslikavo tipov MIME v vrednosti Blob, nize ali obljube teh vrednosti; prazna preslikava sproži TypeError.

types razkrije tipe predstavitev, getType(type) pa vrne Promise<Blob>; če predstavitev manjka, je obljuba zavrnjena z NotFoundError. Izbirna lastnost presentationStyle sprejema "unspecified" (privzeto), "inline" ali "attachment". Statična metoda ClipboardItem.supports(type) preveri podporo za format, ne pa dovoljenj.

Podatke zapiše šele navigator.clipboard.write([item]); navigator.clipboard.read() bere elemente. Za dostop do odložišča veljajo omejitve glede dovoljenj, uporabniške aktivacije in fokusa. Vmesnik zahteva varen kontekst Window. Preverite, ali so uporabljene metode na voljo; specifikacija je osnutek W3C, Node 24 pa ne potrjuje podpore v brskalnikih.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri