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

BCD tables only load in the browser