Clipboard

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Clipboard-Schnittstelle der Clipboard API bietet Lese- und Schreibzugriff auf den Inhalt der Systemzwischenablage. Dies ermöglicht es einer Webanwendung, Funktionen zum Ausschneiden, Kopieren und Einfügen zu implementieren.

EventTarget Clipboard

Die Systemzwischenablage wird über die globale Eigenschaft Navigator.clipboard bereitgestellt.

Alle Methoden der Clipboard API arbeiten asynchron; sie geben ein Promise zurück, das aufgelöst wird, sobald der Zugriff auf die Zwischenablage abgeschlossen ist. Das Versprechen wird abgelehnt, wenn der Zugriff auf die Zwischenablage verweigert wird.

Alle Methoden erfordern einen sicheren Kontext. Zusätzliche Anforderungen für die Nutzung der API werden im Abschnitt Sicherheitsüberlegungen des API-Übersichtsthemas besprochen.

Instanzmethoden

Die Clipboard basiert auf der EventTarget-Schnittstelle und beinhaltet deren Methoden.

read()

Fordert beliebige Daten (wie Bilder) von der Zwischenablage an und gibt ein Promise zurück, das mit einem Array von ClipboardItem-Objekten aufgelöst wird, die den Inhalt der Zwischenablage enthalten.

readText()

Fordert Text aus der Systemzwischenablage an und gibt ein Promise zurück, das mit einem String aufgelöst wird, der den Text der Zwischenablage enthält, sobald er verfügbar ist.

write()

Schreibt beliebige Daten in die Systemzwischenablage und gibt ein Promise zurück, das aufgelöst wird, wenn der Vorgang abgeschlossen ist.

writeText()

Schreibt Text in die Systemzwischenablage und gibt ein Promise zurück, das aufgelöst wird, sobald der Text vollständig in die Zwischenablage kopiert ist.

Spezifikationen

Specification
Clipboard API and events
# clipboard-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Clipboard
read
formats.unsanitized parameter
Experimental
readText
Supports image/png MIME type
Supports text/html MIME type
Supports text/plain MIME type
write
writeText

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.

Siehe auch