Baseline 2024
Newly available
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 des Textinhalts der System-Zwischenablage 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 die writeText()
-Methode verwenden.
Keine.
RückgabewertEin Promise
, das mit einem String erfüllt wird, der den Textinhalt der Zwischenablage enthält.
Gibt einen leeren String zurück, wenn die Zwischenablage leer ist, keinen Text enthält oder keine Textdarstellung unter den Objekten, die den Inhalt der Zwischenablage repräsentieren, enthält.
AusnahmenNotAllowedError
DOMException
Wird ausgelöst, wenn der Zugriff zum Lesen der Zwischenablage nicht erlaubt ist.
NotFoundError
DOMException
Wird ausgelöst, wenn die Zwischenablage angibt, dass sie Daten enthält, die als Text dargestellt werden können, aber keine Textdarstellung bereitstellen kann.
Lesen von der Zwischenablage kann nur in einem sicheren Kontext erfolgen.
Zusätzliche Sicherheitsanforderungen werden im Abschnitt Sicherheitsüberlegungen des API-Ãberblicks behandelt.
BeispieleDieses Beispiel ruft den Textinhalt der Zwischenablage ab und fügt den zurückgegebenen Text in den Inhalt eines ausgewählten Elements ein.
const destination = document.getElementById("outbox");
destinationImage.addEventListener("click", () => {
navigator.clipboard
.readText()
.then((clipText) => (destination.innerText = clipText));
});
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4