Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Clipboard.writeText — zapis tekstu do schowka

Clipboard.writeText zapisuje zwykły tekst do schowka systemowego. Operacja jest asynchroniczna i wymaga bezpiecznego kontekstu oraz zgody przeglądarki na zapis.

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

await navigator.clipboard.writeText(text);

Clipboard.writeText, wywoływane jako navigator.clipboard.writeText(text), zastępuje zawartość schowka zwykłym tekstem, nie HTML. Zwraca Promise, który po zapisie spełnia się wartością undefined.

Wymagany jest bezpieczny kontekst i aktywny dokument z fokusem. Wywołuj metodę bezpośrednio po kliknięciu; aktywacja użytkownika nie gwarantuje zgody. Odmowa może odrzucić obietnicę błędem NotAllowedError.

Używaj await i try...catch; sukces pokazuj dopiero po spełnieniu obietnicy. Sprawdzaj dostępność API w docelowej przeglądarce: Node 24 w repozytorium nie potwierdza obsługi przeglądarkowej.

Przykłady

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

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

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

Wynik

Copied: CKTIS

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

Źródła