KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Clipboard — asynchrone toegang tot het klembord

Clipboard biedt via navigator.clipboard toegang tot het systeemklembord; de bewerkingen zijn asynchroon en onderworpen aan beveiligingsbeperkingen.

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

Syntax

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

Clipboard, toegankelijk via navigator.clipboard, is een Web API-interface en geen onderdeel van ECMAScript. readText() retourneert tekst, writeText() schrijft tekst; read() en write() verwerken ClipboardItem-objecten. De methoden retourneren promises.

Een beveiligde context en focus op het document zijn vereist. Machtigingen en gebruikersactivatie kunnen de toegang beperken; klikken garandeert geen succes. Handel afgewezen promises af, waaronder NotAllowedError. Controleer welke functies beschikbaar zijn; het W3C-concept garandeert geen browserondersteuning, en Node 24 bewijst die evenmin.

Dit verschilt van de synchrone copy-, cut- en paste-gebeurtenissen met event.clipboardData. Het klembord kan geheimen bevatten: lees het niet zonder dat daarom is gevraagd. Het voorbeeld overschrijft het klembord pas na een klik.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen