WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Clipboard.read — asynchrones Lesen der Zwischenablage

Die Methode navigator.clipboard.read() liest Elemente der Zwischenablage samt ihren MIME-Repräsentationen. Sie erfordert einen sicheren Kontext und die Genehmigung des Browsers für den Zugriff.

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.read()
navigator.clipboard.read({ unsanitized: ["text/html"] })

Clipboard.read, aufgerufen als navigator.clipboard.read(), gibt ein Promise für ein Array von ClipboardItem-Objekten zurück, nicht für Text. item.types listet die MIME-Typen auf; await item.getType(type) liefert ein Blob. Im Gegensatz dazu liest readText() Text als Zeichenfolge.

Dies ist eine Web API und kein ECMAScript-Feature. Sie erfordert einen sicheren Kontext sowie ein aktives Dokument mit Fokus. Rufe sie nach einer Nutzeraktion auf; ein Klick garantiert keinen Zugriff. Eine Ablehnung kann NotAllowedError auslösen. Das Erkennen der Methode bestätigt keine Berechtigung; Node 24 ist kein Beleg für Browserunterstützung.

Die Option { unsanitized: ["text/html"] } fordert nicht bereinigtes HTML an, garantiert dieses Ergebnis aber nicht. Behandle Daten aus der Zwischenablage als nicht vertrauenswürdig und füge sie nicht direkt über innerHTML ein. Das Beispiel zeigt Text mit textContent an.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Clipboard.read without clipboard access</title>
</head>
<body>
  <p id="result" role="status"></p>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Clipboard.read permission test';
    frame.hidden = true;
    frame.allow = "clipboard-read 'none'";
    frame.srcdoc = `<!doctype html>
      <html lang="en"><head><meta charset="utf-8">
      <title>Clipboard.read test</title></head><body>
      <script>
        (async () => {
          const blocked = 'Clipboard.read(): unavailable or denied';
          const clipboard = navigator.clipboard;
          const policy = document.featurePolicy;
          // Only call the native API if the policy recognizes and denies clipboard-read.
          if (typeof clipboard?.read !== 'function' ||
              !policy?.features?.().includes('clipboard-read') ||
              policy.allowsFeature?.('clipboard-read') !== false) {
            parent.postMessage(blocked, '*');
            return;
          }
          try {
            await clipboard.read();
            parent.postMessage('Clipboard.read(): unexpectedly allowed', '*');
          } catch (error) {
            parent.postMessage(error.name === 'NotAllowedError' ? blocked :
              'Clipboard.read(): ' + error.name, '*');
          }
        })();
      <\/script></body></html>`;
    window.addEventListener('message', (event) => {
      if (event.source === frame.contentWindow) {
        document.querySelector('#result').textContent = event.data;
      }
    });
    document.body.append(frame);
  </script>
</body>
</html>

Ergebnis

Clipboard.read(): unavailable or denied

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