WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Navigator.clipboard — asynchroner Zugriff auf die Zwischenablage

Navigator.clipboard stellt ein Clipboard-Objekt zum asynchronen Lesen und Schreiben der Systemzwischenablage bereit. Erfordert einen sicheren Kontext; der Zugriff unterliegt Einschränkungen des Browsers.

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
const text = await navigator.clipboard.readText();
await navigator.clipboard.writeText(text)

Navigator.clipboard, zugänglich über navigator.clipboard, ist eine schreibgeschützte Eigenschaft, die bei wiederholtem Lesen dasselbe Clipboard-Objekt zurückgibt. Sie speichert Text nicht direkt: readText() gibt ein Promise mit Text zurück, während writeText(text) ein Promise zurückgibt, das nach dem Schreiben ohne Wert erfüllt wird. read() und write() verarbeiten Daten, die durch ClipboardItem dargestellt werden.

Dies ist eine Web-API und kein ECMAScript-Feature; die Verwendung von Node 24 in einem Repository belegt keine Browserunterstützung. Erforderlich sind ein sicherer Kontext sowie ein fokussiertes, aktives Dokument. Berechtigungen und Anforderungen an die Benutzeraktivierung hängen vom Browser ab: Rufe den Schreibvorgang direkt bei einem Klick auf und behandle Ablehnungen, einschließlich NotAllowedError. Das Erkennen einer Methode garantiert keinen Zugriff.

Im Gegensatz zu ClipboardEvent.clipboardData, das zu Kopier- und Einfügeereignissen gehört, ist diese Schnittstelle asynchron. Die Zwischenablage kann vertrauliche Daten enthalten; lies sie nur für einen klar definierten Zweck aus und warne, bevor du ihren Inhalt ersetzt.

Beispiele

<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Navigator clipboard write</title></head>
<body>
  <button type="button">Copy sample text</button>
  <p role="status"></p>
  <script>
    const button = document.querySelector('button');
    const status = document.querySelector('[role="status"]');
    const clipboard = navigator.clipboard;
    const canAttemptWrite = window.isSecureContext &&
      typeof clipboard?.writeText === 'function';

    status.textContent = canAttemptWrite
      ? 'Click to request a clipboard write.'
      : 'Clipboard write is unavailable in this document.';
    button.disabled = !canAttemptWrite;
    console.log(status.textContent);

    button.addEventListener('click', async () => {
      try {
        await clipboard.writeText('CKTIS');
        status.textContent = 'Sample text copied.';
      } catch (error) {
        status.textContent = 'Clipboard write failed: ' + error.name;
      }
    });
  </script>
</body>
</html>

Ergebnis

Before interaction, the page reports whether a user-initiated clipboard write can be attempted. If it can, clicking the button reports either success or the browser's error name.

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