Zwischenablage
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2020.
* Some parts of this feature may have varying levels of support.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das Clipboard-Interface der Zwischenablage-API bietet Lese- und Schreibzugriff auf die Inhalte der Systemzwischenablage. Dies ermöglicht es einer Webanwendung, Funktionen zum Ausschneiden, Kopieren und Einfügen zu implementieren.
Die Systemzwischenablage wird über die globale Eigenschaft Navigator.clipboard bereitgestellt.
Alle Methoden der Zwischenablage-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. Weitere Anforderungen für die Nutzung der API werden im Abschnitt Sicherheitsüberlegungen des API-Übersichtsthemas erläutert.
Instanzmethoden
Clipboard basiert auf dem EventTarget-Interface und enthält dessen Methoden.
read()-
Fordert beliebige Daten (wie Bilder) aus der Zwischenablage an und gibt ein
Promisezurück, das mit einem Array vonClipboardItem-Objekten aufgelöst wird, die die Inhalte der Zwischenablage enthalten. readText()-
Fordert Text aus der Systemzwischenablage an und gibt ein
Promisezurü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
Promisezurück, das bei Abschluss der Operation aufgelöst wird. writeText()-
Schreibt Text in die Systemzwischenablage und gibt ein
Promisezurück, das aufgelöst wird, sobald der Text vollständig in die Zwischenablage kopiert wurde.
Spezifikationen
| Specification |
|---|
| Clipboard API and events # clipboard-interface |