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.
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
Promisezurück, das mit einem Array vonClipboardItem-Objekten aufgelöst wird, die den Inhalt 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 aufgelöst wird, wenn der Vorgang abgeschlossen ist. writeText()-
Schreibt Text in die Systemzwischenablage und gibt ein
Promisezurü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
BCD tables only load in the browser