Clipboard: readText() Methode
Baseline
2024
Newly available
Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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
| Specification |
|---|
| Clipboard API and events # dom-clipboard-readtext |