WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Clipboard.writeText — Text in die Zwischenablage schreiben

Clipboard.writeText schreibt einfachen Text in die Systemzwischenablage. Der Vorgang ist asynchron und erfordert einen sicheren Kontext sowie die Berechtigung des Browsers zum Schreiben.

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

await navigator.clipboard.writeText(text);

Clipboard.writeText, aufgerufen als navigator.clipboard.writeText(text), ersetzt den Inhalt der Zwischenablage durch einfachen Text, nicht durch HTML. Die Methode gibt ein Promise zurück, das nach dem Schreiben mit undefined erfüllt wird.

Erforderlich sind ein sicherer Kontext und ein fokussiertes, aktives Dokument. Rufe die Methode direkt als Reaktion auf einen Klick auf; eine Benutzeraktivierung garantiert keine Berechtigung. Eine Ablehnung kann dazu führen, dass das Promise mit NotAllowedError zurückgewiesen wird.

Verwende await und try...catch; melde den Erfolg erst, wenn das Promise erfüllt wurde. Prüfe die Verfügbarkeit der API im Zielbrowser: Node 24 im Repository belegt keine Browserunterstützung.

Beispiele

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

Ergebnis

Copied: 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