Zwischenablage: writeText() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die writeText() Methode der Clipboard Schnittstelle schreibt den angegebenen Text in die Systemzwischenablage und gibt ein Promise zurück, das aufgelöst wird, sobald die Systemzwischenablage aktualisiert wurde.
Syntax
writeText(newClipText)
Parameter
newClipText-
Der String, der in die Zwischenablage geschrieben werden soll.
Rückgabewert
Ein Promise, das aufgelöst wird, sobald der Inhalt der Zwischenablage aktualisiert wurde.
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn das Schreiben in die Zwischenablage nicht erlaubt ist.
Sicherheitsüberlegungen
Das Schreiben in die Zwischenablage kann nur in einem sicheren Kontext durchgeführt werden.
Zusätzliche Sicherheitsanforderungen sind im Abschnitt Sicherheitsüberlegungen des API-Übersichtsthemas enthalten.
Beispiele
Dieses Beispiel setzt den Inhalt der Zwischenablage auf den String "<empty clipboard>".
button.addEventListener("click", () => writeClipboardText("<empty clipboard>"));
async function writeClipboardText(text) {
try {
await navigator.clipboard.writeText(text);
} catch (error) {
console.error(error.message);
}
}
Spezifikationen
| Spezifikation |
|---|
| Clipboard API and events # dom-clipboard-writetext |