Clipboard
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das Clipboard-Interface der Clipboard API bietet Lese- und Schreibzugriff auf den Inhalt der Systemzwischenablage.
Damit kann eine Webanwendung Funktionen zum Ausschneiden, Kopieren und Einfügen implementieren.
Die Systemzwischenablage ist über die globale Eigenschaft Navigator.clipboard zugänglich.
Alle Methoden der Clipboard API arbeiten asynchron. Sie geben ein Promise zurück, das erfüllt wird, sobald der Zugriff auf die Zwischenablage abgeschlossen ist.
Wird der Zugriff auf die Zwischenablage verweigert, wird das Promise zurückgewiesen.
Alle Methoden erfordern einen sicheren Kontext. Weitere Voraussetzungen für die Verwendung der API werden im Abschnitt Sicherheitsaspekte des API-Überblicks erläutert.
Instanzmethoden
Clipboard basiert auf dem Interface EventTarget und umfasst dessen Methoden.
read()-
Liest die Einträge in der Systemzwischenablage und gibt ein
Promisezurück, das erfüllt wird, wenn der Vorgang abgeschlossen ist. Jeder Eintrag ist einClipboardItem, das mehrere Darstellungen der kopierten Daten enthalten kann, beispielsweise als HTML und Text. readText()-
Fordert Text aus der Systemzwischenablage an und gibt ein
Promisezurück, das mit einer Zeichenfolge erfüllt wird, die den Text aus der Zwischenablage enthält, sobald er verfügbar ist. write()-
Schreibt ein oder mehrere
ClipboardItem-Objekte in die Systemzwischenablage und gibt einPromisezurück, das erfüllt wird, wenn der Vorgang abgeschlossen ist. writeText()-
Schreibt Text in die Systemzwischenablage und gibt ein
Promisezurück, das erfüllt wird, sobald der Text vollständig in die Zwischenablage kopiert wurde.
Ereignisse
clipboardchange-
Wird ausgelöst, wenn sich der Inhalt der Systemzwischenablage auf irgendeine Weise ändert, beispielsweise durch einen Kopierbefehl des Systems oder durch eine API-Methode wie
Clipboard.writeText().
Spezifikationen
| Spezifikation |
|---|
| Clipboard API and events # clipboard-interface |