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

BCD tables only load in the browser

Siehe auch