Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ClipboardItem — element schowka z reprezentacjami MIME

ClipboardItem opisuje jeden element schowka, który może mieć kilka reprezentacji MIME. Konstruktor przygotowuje dane; sam nie zapisuje ich w schowku systemowym.

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

Składnia

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

ClipboardItem należy do Web APIs, nie do ECMAScript. Jeden obiekt może zawierać różne reprezentacje tej samej treści. Konstruktor przyjmuje niepustą mapę typów MIME na wartości Blob, ciągi znaków lub obietnice tych wartości; pusta mapa powoduje TypeError.

types udostępnia typy reprezentacji, a getType(type) zwraca Promise<Blob>; brak reprezentacji oznacza odrzucenie z NotFoundError. Opcjonalne presentationStyle przyjmuje "unspecified" (domyślnie), "inline" lub "attachment". Statyczne ClipboardItem.supports(type) sprawdza obsługę formatu, nie uprawnienia.

Dopiero navigator.clipboard.write([item]) zapisuje dane; navigator.clipboard.read() odczytuje elementy. Dostęp do schowka podlega ograniczeniom uprawnień, aktywacji użytkownika i fokusu. Interfejs wymaga bezpiecznego kontekstu Window. Sprawdzaj dostępność używanych metod; specyfikacja jest projektem W3C, a Node 24 nie potwierdza obsługi w przeglądarce.

Przykłady

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

Wynik

ClipboardItem unavailable

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła