KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ClipboardItem — een klemborditem met MIME-representaties

ClipboardItem beschrijft één klemborditem dat meerdere MIME-representaties kan hebben. De constructor bereidt gegevens voor, maar schrijft die niet zelf naar het systeemklembord.

Versie: 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 hoort bij de Web APIs, niet bij ECMAScript. Eén object kan verschillende representaties van dezelfde inhoud bevatten. De constructor accepteert een niet-lege map van MIME-typen naar Blob-waarden, tekenreeksen of promises van zulke waarden; een lege map veroorzaakt een TypeError.

types geeft de representatietypen weer en getType(type) retourneert een Promise<Blob>; ontbreekt een representatie, dan wordt de promise afgewezen met NotFoundError. De optionele eigenschap presentationStyle accepteert "unspecified" (standaard), "inline" of "attachment". De statische methode ClipboardItem.supports(type) controleert of een indeling wordt ondersteund, niet de machtigingen.

Alleen navigator.clipboard.write([item]) schrijft de gegevens; navigator.clipboard.read() leest items. Voor toegang tot het klembord gelden beperkingen op basis van machtigingen, gebruikersactivatie en focus. De interface vereist een veilige Window-context. Controleer of de gebruikte methoden beschikbaar zijn; de specificatie is een W3C-ontwerp en Node 24 bewijst geen ondersteuning in browsers.

Voorbeelden

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

Resultaat

ClipboardItem unavailable

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen