WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Clipboard — asynchroner Zugriff auf die Zwischenablage

Clipboard stellt die Systemzwischenablage über navigator.clipboard bereit; die Vorgänge sind asynchron und unterliegen Sicherheitseinschränkungen.

Version: 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, erreichbar über navigator.clipboard, ist eine Web-API-Schnittstelle und kein Bestandteil von ECMAScript. readText() gibt Text zurück, writeText() schreibt Text; read() und write() verarbeiten ClipboardItem-Objekte. Die Methoden geben Promises zurück.

Ein sicherer Kontext und der Fokus des Dokuments sind erforderlich. Berechtigungen und eine Nutzeraktivierung können den Zugriff einschränken; ein Klick garantiert keinen Erfolg. Behandle abgelehnte Promises, darunter NotAllowedError. Prüfe die verfügbaren Funktionen; der W3C-Entwurf garantiert keine Browserunterstützung, und auch Node 24 belegt sie nicht.

Dies unterscheidet sich von den synchronen copy-, cut- und paste-Ereignissen mit event.clipboardData. Die Zwischenablage kann Geheimnisse enthalten: Vermeide ungefragtes Auslesen. Das Beispiel überschreibt die Zwischenablage erst nach einem Klick.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen