Clipboard: writeText() Methode

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 System-Zwischenablage und gibt ein Promise zurück, das aufgelöst wird, sobald die System-Zwischenablage aktualisiert wurde.

Syntax

js
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

NotAllowedError DOMException

Wird ausgelöst, wenn das Schreiben in die Zwischenablage nicht erlaubt ist.

Sicherheitserwägungen

Das Schreiben in die Zwischenablage kann nur in einem sicheren Kontext erfolgen.

Weitere Sicherheitsanforderungen sind im Abschnitt Sicherheitserwägungen des API-Überblicks behandelt.

Beispiele

Dieses Beispiel setzt den Inhalt der Zwischenablage auf den String "<empty clipboard>".

js
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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
writeText

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch