Navigator: clipboard-Eigenschaft

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte clipboard-Eigenschaft der Navigator-Schnittstelle gibt ein Clipboard-Objekt zurück, das zum Lesen und Schreiben der Inhalte der Zwischenablage verwendet wird.

Dies ist der Einstiegspunkt in die Clipboard-API, die zum Implementieren von Funktionen zum Ausschneiden, Kopieren und Einfügen innerhalb einer Webanwendung verwendet werden kann.

Wert

Das Clipboard-Objekt, das zum Zugriff auf die System-Zwischenablage verwendet wird.

Beispiele

Der folgende Code verwendet navigator.clipboard, um auf die System-Zwischenablage zuzugreifen und Textinhalte aus der Zwischenablage zu lesen.

js
navigator.clipboard
  .readText()
  .then(
    (clipText) => (document.querySelector(".clip-text").innerText = clipText),
  );

Dieses Snippet ersetzt den Inhalt des Elements, dessen Klasse "clip-text" ist, mit den Textinhalten der Zwischenablage. Vielleicht wird dieser Code in einer Browsererweiterung verwendet, die den aktuellen Zwischenspeicherinhalt anzeigt und sich automatisch periodisch oder bei bestimmten Ereignissen aktualisiert.

Wenn die Zwischenablage leer ist oder keinen Text enthält, wird der Inhalt des "clip-text"-Elements gelöscht. Dies geschieht, weil readText() einen leeren String zurückgibt, wenn die Zwischenablage leer ist oder keinen Text enthält.

Spezifikationen

Specification
Clipboard API and events
# navigator-clipboard

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
clipboard

Legend

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

Full support
Full support
No support
No support