Clipboard: readText() Methode
Baseline
2024
Neu verfügbar
Seit April 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die readText()-Methode der Clipboard-Schnittstelle gibt ein Promise zurück, das mit einer Kopie der Textinhalte der Systemzwischenablage erfüllt wird.
Hinweis:
Um nicht-textuelle Inhalte aus der Zwischenablage zu lesen, verwenden Sie stattdessen die read()-Methode.
Sie können Text in die Zwischenablage schreiben, indem Sie writeText() verwenden.
Syntax
readText()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit einem String aufgelöst wird, der die Textinhalte der Zwischenablage enthält.
Gibt einen leeren String zurück, wenn die Zwischenablage leer ist, keinen Text enthält oder keine textuelle Darstellung unter den Objekten besitzt, die den Inhalt der Zwischenablage repräsentieren.
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn der Zugriff auf das Lesen der Zwischenablage nicht erlaubt ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn die Zwischenablage anzeigt, dass sie Daten enthält, die als Text dargestellt werden können, aber keine textuelle Darstellung bereitgestellt werden kann.
Sicherheitserwägungen
Das Lesen von der Zwischenablage kann nur in einem sicheren Kontext erfolgen.
Zusätzliche Sicherheitsanforderungen werden im Abschnitt Sicherheitserwägung des API-Übersichtsthemas behandelt.
Beispiele
Dieses Beispiel ruft die Textinhalte der Zwischenablage ab und fügt den zurückgegebenen Text in die Inhalte eines ausgewählten Elements ein.
const destination = document.getElementById("outbox");
destinationImage.addEventListener("click", () => {
navigator.clipboard
.readText()
.then((clipText) => (destination.innerText = clipText));
});
Spezifikationen
| Spezifikation |
|---|
| Clipboard API and events # dom-clipboard-readtext |