Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Clipboard — asinhroni dostop do odložišča

Clipboard omogoča dostop do sistemskega odložišča prek navigator.clipboard; operacije so asinhrone in zanje veljajo varnostne omejitve.

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

Sintaksa

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

Clipboard, dostopen prek navigator.clipboard, je vmesnik Web API, ne ECMAScripta. readText() vrne besedilo, writeText() ga zapiše; read() in write() obravnavata objekte ClipboardItem. Metode vrnejo obljube.

Potreben je varen kontekst in fokus dokumenta. Dovoljenja in uporabniška aktivacija lahko omejijo dostop; klik ne zagotavlja uspeha. Obravnavaj zavrnitve, tudi NotAllowedError. Preveri, katere funkcije so na voljo; osnutek W3C ne zagotavlja podpore v brskalnikih, prav tako je ne dokazuje Node 24.

To se razlikuje od sinhronih dogodkov copy, cut in paste, ki uporabljajo event.clipboardData. Odložišče lahko vsebuje skrivnosti: ne beri ga, če to ni bilo zahtevano. Primer prepiše vsebino odložišča šele po kliku.

Primeri

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;
  }
});

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri