Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Clipboard — asynchroniczny dostęp do schowka

Clipboard udostępnia schowek systemowy przez navigator.clipboard; operacje są asynchroniczne i podlegają ograniczeniom bezpieczeństwa.

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

navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>

Clipboard, dostępny przez navigator.clipboard, jest interfejsem Web API, nie ECMAScript. readText() zwraca tekst, writeText() zapisuje tekst; read() i write() obsługują obiekty ClipboardItem. Metody zwracają obietnice.

Wymagane są bezpieczny kontekst i fokus dokumentu. Uprawnienia oraz aktywacja użytkownika mogą ograniczać dostęp; kliknięcie nie gwarantuje powodzenia. Obsługuj odrzucenia, w tym NotAllowedError. Wykrywaj funkcje; szkic W3C nie gwarantuje obsługi przeglądarki, a Node 24 jej nie dowodzi.

To nie synchroniczne zdarzenia copy, cut, paste z event.clipboardData. Schowek może zawierać sekrety: unikaj nieproszonego odczytu. Przykład nadpisuje schowek dopiero po kliknięciu.

Przykłady

const button = document.createElement('button');
const status = document.createElement('p');
button.textContent = 'Copy CKTIS';
status.setAttribute('role', 'status');
document.body.append(button, status);

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.writeText !== 'function') {
    status.textContent = 'Clipboard unavailable';
    return;
  }

  button.disabled = true;
  try {
    await navigator.clipboard.writeText('CKTIS');
    status.textContent = 'Copied: CKTIS';
  } catch (error) {
    status.textContent = `Copy failed: ${error.name}`;
  } finally {
    button.disabled = false;
  }
});

Wynik

On an allowed, successful click: Copied: CKTIS
Clipboard text: CKTIS

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

Źródła