Clipboard API

Die Systemzwischenablage ist ein Datenpuffer, der dem Betriebssystem gehört, auf dem der Browser läuft, und der für die kurzfristige Datenspeicherung und/oder Datenübertragung zwischen Dokumenten oder Anwendungen verwendet wird. Sie wird normalerweise als anonymer, temporärer Datenpuffer implementiert, manchmal auch Paste-Puffer genannt, der von den meisten oder allen Programmen innerhalb der Umgebung über definierte Programmierschnittstellen zugänglich ist.

Die Clipboard API ermöglicht es Benutzern, textuelle und andere Arten von Daten programmgesteuert von und in die Systemzwischenablage zu lesen und zu schreiben, sofern sichere Kontexte verwendet werden und der Benutzer die in den Sicherheitsüberlegungen dargelegten Kriterien erfüllt hat.

Ereignisse werden als Ergebnis von cut-, copy- und paste-Operationen ausgelöst, die die Zwischenablage ändern. Die Ereignisse haben eine Standardaktion, zum Beispiel kopiert die copy-Aktion standardmäßig die aktuelle Auswahl in die Systemzwischenablage. Die Standardaktion kann vom Ereignis-Handler überschrieben werden – sehen Sie sich jedes der Ereignisse für weitere Informationen an.

Clipboard Sicherer Kontext

Bietet eine Schnittstelle zum Lesen und Schreiben von Text und Daten in die bzw. aus der Systemzwischenablage. Die Spezifikation bezeichnet dies als 'Async Clipboard API'.

ClipboardEvent

Repräsentiert Ereignisse, die Informationen zur Änderung der Zwischenablage bereitstellen, d.h. cut-, copy- und paste-Ereignisse. Die Spezifikation bezeichnet dies als 'Clipboard Event API'.

ClipboardItem Sicherer Kontext

Repräsentiert ein einzelnes Elementformat, das beim Lesen oder Schreiben von Daten verwendet wird.

Die Clipboard API erweitert die folgenden APIs und fügt die aufgelisteten Funktionen hinzu.

Navigator.clipboard Schreibgeschützt Sicherer Kontext

Gibt ein Clipboard-Objekt zurück, das Lese- und Schreibzugriff auf die Systemzwischenablage bietet.

Element copy-Ereignis

Ein Ereignis, das jedes Mal ausgelöst wird, wenn der Benutzer eine Kopieraktion einleitet.

Element cut-Ereignis

Ein Ereignis, das jedes Mal ausgelöst wird, wenn der Benutzer eine Ausschneideaktion einleitet.

Element paste-Ereignis

Ein Ereignis, das jedes Mal ausgelöst wird, wenn der Benutzer eine Einfügeaktion einleitet.

Die Clipboard API ermöglicht es Benutzern, textuelle und andere Arten von Daten programmgesteuert von und in die Systemzwischenablage zu lesen und zu schreiben, sofern sichere Kontexte verwendet werden.

Die Spezifikation erfordert, dass der Benutzer kürzlich mit der Seite interagiert hat, um von der Zwischenablage zu lesen (vorübergehende Benutzeraktivierung ist erforderlich). Wenn die Leseoperation durch Benutzerinteraktion mit einem Browser- oder OS-"Paste-Element" (wie z.B. einem Kontextmenü) verursacht wird, sollte der Browser den Benutzer um Bestätigung bitten. Zum Schreiben in die Zwischenablage erwartet die Spezifikation, dass der Seite die Berechtigung clipboard-write der Permissions API erteilt wurde, und der Browser kann auch vorübergehende Benutzeraktivierung erfordern. Browser können zusätzliche Einschränkungen für die Verwendung der Methoden zum Zugriff auf die Zwischenablage erlassen.

Die Implementierungen der Browser weichen von der Spezifikation ab. Die Unterschiede sind im Abschnitt Browser-Kompatibilität erfasst, und der aktuelle Stand wird unten zusammengefasst:

Chromium-Browser:

• Lesen erfordert das Erteilen der Berechtigung clipboard-read der Permissions API. Eine vorübergehende Aktivierung ist nicht erforderlich.
• Schreiben erfordert entweder die Berechtigung clipboard-write oder eine vorübergehende Aktivierung. Wenn die Berechtigung erteilt wird, bleibt sie bestehen, und eine erneute vorübergehende Aktivierung ist nicht erforderlich.
• Die HTTP-Permissions-Policy-Berechtigungen clipboard-read und clipboard-write müssen für <iframe>-Elemente, die auf die Zwischenablage zugreifen, erlaubt sein.
• Beim Lesen durch ein Browser- oder OS-"Paste-Element" wird kein dauerhaftes Einfüge-Dialogfeld angezeigt.

Firefox & Safari:

• Lesen und Schreiben erfordert eine vorübergehende Aktivierung.
• Der Einfüge-Dialog wird unterdrückt, wenn Inhalte derselben Herkunft von der Zwischenablage gelesen werden, jedoch nicht bei Inhalten verschiedener Herkunft.
• Die Berechtigungen clipboard-read und clipboard-write werden von Firefox oder Safari nicht unterstützt (und sind auch nicht zur Unterstützung geplant).

Firefox Web Extensions:

• Das Lesen von Text ist nur für Erweiterungen mit der Web Extension-Berechtigung clipboardRead verfügbar. Mit dieser Berechtigung benötigt die Erweiterung keine vorübergehende Aktivierung oder eine Einfügeaufforderung.
• Das Schreiben von Text ist in einem sicheren Kontext und mit vorübergehender Aktivierung verfügbar. Mit der Web Extension-Berechtigung clipboardWrite ist keine vorübergehende Aktivierung erforderlich.

Die Systemzwischenablage wird über den globalen Navigator.clipboard zugänglich gemacht.

Dieses Snippet holt den Text aus der Zwischenablage und fügt ihn dem ersten Element hinzu, das mit der Klasse editor gefunden wird. Da readText() einen leeren String zurückgibt, wenn die Zwischenablage keinen Text enthält, ist dieser Code sicher.

navigator.clipboard
  .readText()
  .then(
    (clipText) => (document.querySelector(".editor").innerText += clipText),
  );

• Bildunterstützung für Async Clipboard-Artikel