CKTIS / JavaScript
Clipboard.write — asynchrones Schreiben in die Zwischenablage
Clipboard.write schreibt ClipboardItem-Objekte in die Systemzwischenablage. Es unterstützt alternative MIME-Darstellungen, erfordert jedoch einen sicheren Kontext und die Genehmigung des Browsers.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
await navigator.clipboard.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);Clipboard.write, aufgerufen als navigator.clipboard.write(items), akzeptiert ClipboardItem-Objekte. Ein Element kann mehrere MIME-Darstellungen desselben Inhalts enthalten. Für reinen Text ist writeText(text) einfacher. Das zurückgegebene Promise wird nach dem Schreiben mit undefined erfüllt; verweigerter Zugriff kann NotAllowedError verursachen.
Dies ist eine Web API, kein Teil von ECMAScript; Node 24 belegt keine Browserunterstützung. Prüfe, ob die API verfügbar ist, und teste die Zielbrowser. Verwende einen sicheren Kontext: HTTPS oder einen vertrauenswürdigen lokalen Ursprung wie localhost. HTTPS allein garantiert keinen sicheren Kontext, wenn die Seite unter einem unsicheren Vorfahren eingebettet ist; prüfe window.isSecureContext.
Führe den Schreibvorgang direkt nach einem Klick in einem fokussierten Dokument aus und behandle Fehler; die Berechtigungsrichtlinien unterscheiden sich je nach Browser. Verwechsle mehrere Darstellungen nicht mit mehreren Elementen: Die Plattform behält möglicherweise nur das erste Element. Das Beispiel überschreibt die Zwischenablage nach einem absichtlichen Klick der Nutzerin oder des Nutzers.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>Clipboard.write</title>
<button id="copy" type="button">Copy: Hello, clipboard!</button>
<output id="status" aria-live="polite"></output>
<script>
const button = document.querySelector('#copy');
const status = document.querySelector('#status');
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.write !== 'function' ||
typeof ClipboardItem !== 'function') {
status.textContent = 'Unavailable';
return;
}
try {
const blob = new Blob(['Hello, clipboard!'], { type: 'text/plain' });
const item = new ClipboardItem({ 'text/plain': blob });
await navigator.clipboard.write([item]);
status.textContent = 'Copied';
} catch (error) {
status.textContent = `Failed: ${error.name}`;
}
});
</script>Ergebnis
The status is initially empty. After the user clicks the button, it displays `Copied` only if the clipboard write succeeds. If the context is insecure or the required API is unavailable, it displays `Unavailable`. If an error occurs while preparing or writing the clipboard item, it displays `Failed: ` followed by the error name.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.