База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

ClipboardItem — елемент от клипборда с MIME представяния

ClipboardItem описва един елемент от клипборда, който може да има няколко MIME представяния. Конструкторът подготвя данните, но сам не ги записва в системния клипборд.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

ClipboardItem принадлежи към Web API, а не към ECMAScript. Един обект може да съдържа различни представяния на едно и също съдържание. Конструкторът приема непразна карта от MIME типове към стойности Blob, низове или обещания за такива стойности; празна карта предизвиква TypeError.

types предоставя типовете представяния, а getType(type) връща Promise<Blob>; ако дадено представяне липсва, обещанието се отхвърля с NotFoundError. Незадължителното свойство presentationStyle приема "unspecified" (по подразбиране), "inline" или "attachment". Статичният метод ClipboardItem.supports(type) проверява поддръжката на формата, а не разрешенията.

Данните се записват само чрез navigator.clipboard.write([item]); navigator.clipboard.read() чете елементи. Достъпът до клипборда е ограничен от разрешенията, потребителската активация и фокуса. Интерфейсът изисква защитен контекст Window. Проверявайте наличността на използваните методи; спецификацията е проект на W3C, а Node 24 не доказва поддръжка в браузърите.

Примери

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

Резултат

ClipboardItem unavailable

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници