Zwischenablage: writeText() Methode
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.
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
| Specification |
|---|
| Clipboard API and events # dom-clipboard-writetext |