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 Clipboard API ermöglicht Lese- und Schreibzugriff auf den Inhalt der Systemzwischenablage. Dies ermöglicht es einer Webanwendung, Funktionen wie Ausschneiden, Kopieren und Einfügen zu implementieren.
Die Systemzwischenablage wird über die globale Navigator.clipboard-Eigenschaft bereitgestellt.
Alle Methoden der Clipboard API arbeiten asynchron; sie geben ein Promise zurück, das aufgelöst wird, sobald auf die Zwischenablage zugegriffen wurde. Das Versprechen wird abgelehnt, wenn der Zugriff auf die Zwischenablage verweigert wird.
Alle Methoden erfordern einen sicheren Kontext. Zusätzliche Anforderungen zur Nutzung der API werden im Abschnitt Sicherheitsüberlegungen des API-Übersichtsthemas behandelt.
Instanzmethoden
Clipboard basiert auf dem EventTarget-Interface und enthält dessen 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 von 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 wurde.
Ereignisse
clipboardchangeExperimentell-
Wird ausgelöst, wenn sich der Inhalt der Systemzwischenablage in irgendeiner Weise ändert, zum Beispiel durch einen Systemkopierbefehl oder durch eine API-Methode wie
Clipboard.writeText().
Spezifikationen
| Specification |
|---|
| Clipboard API and events # clipboard-interface |