CKTIS / JavaScript
ClipboardItem — položka schránky s reprezentáciami MIME
ClipboardItem opisuje jednu položku schránky, ktorá môže mať niekoľko reprezentácií MIME. Konštruktor pripraví údaje, ale sám ich nezapíše do systémovej schránky.
Verzia: 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 patrí do Web APIs, nie do ECMAScriptu. Jeden objekt môže obsahovať rôzne reprezentácie toho istého obsahu. Konštruktor prijíma neprázdnu mapu typov MIME na hodnoty Blob, reťazce alebo prísľuby týchto hodnôt; prázdna mapa vyvolá TypeError.
types sprístupňuje typy reprezentácií a getType(type) vracia Promise<Blob>; ak reprezentácia chýba, prísľub sa zamietne s NotFoundError. Voliteľná vlastnosť presentationStyle prijíma "unspecified" (predvolená hodnota), "inline" alebo "attachment". Statická metóda ClipboardItem.supports(type) overuje podporu formátu, nie povolenia.
Údaje zapíše až navigator.clipboard.write([item]); navigator.clipboard.read() číta položky. Prístup k schránke podlieha obmedzeniam povolení, aktivácie používateľom a fokusu. Rozhranie vyžaduje zabezpečený kontext Window. Overte dostupnosť používaných metód; špecifikácia je návrhom W3C a Node 24 nepotvrdzuje podporu v prehliadačoch.
Prí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ýsledok
ClipboardItem unavailable
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.