Abschnitt 19 · Lektion 4
Zwischenablage und Teilen
Ein Kopieren-Button neben einem Befehl spart das Markieren, und auf dem Telefon öffnet ein Teilen-Button den Dialog mit allen Apps. Beides hängt an Bedingungen, die der Browser stellt. Diese Ansicht erfüllt nicht alle davon, und deshalb hat die Lektion keine Aufgabe.
Wann Kopieren klappt
<p><code id="befehl">npm run dev</code></p>
<p><button id="kopieren" type="button">Kopieren</button></p>
<p id="rueckmeldung"></p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
} const button = document.getElementById("kopieren");
const befehl = document.getElementById("befehl");
const rueckmeldung = document.getElementById("rueckmeldung");
// Erst prüfen, ob es die API überhaupt gibt. In dieser
// Seite gibt es sie meistens schon. Chrome lehnt hier erst
// das Schreiben ab, warum, steht in der Lektion.
if (!navigator.clipboard) {
rueckmeldung.textContent = "Die Zwischenablage steht hier nicht zur Verfügung.";
button.disabled = true;
}
button.addEventListener("click", async () => {
try {
// writeText gibt ein Promise zurück.
await navigator.clipboard.writeText(befehl.textContent);
// Ohne Rückmeldung weiß niemand, ob etwas passiert ist.
rueckmeldung.textContent = "Kopiert.";
setTimeout(() => {
rueckmeldung.textContent = "";
}, 2000);
} catch (fehler) {
rueckmeldung.textContent = "Kopieren hat nicht geklappt. Bitte von Hand markieren.";
console.warn("Kopieren abgelehnt:", fehler.name);
}
}); navigator.clipboard.writeText(text) schreibt Text in die Zwischenablage und gibt ein Promise zurück. Das klappt nur unter zwei Bedingungen.
- Ein sicherer Kontext. Die Seite muss über
httpsgeladen sein,localhostzählt auch. Überhttpgibt es die API schlicht nicht. Ob das erfüllt ist, verrätwindow.isSecureContextin der Eingabezeile der Console. - Eine echte Nutzergeste. Der Aufruf kommt aus einem Klick oder Tastendruck heraus, den ein Mensch ausgelöst hat. Ein Skript, das beim Laden in die Zwischenablage schreibt, weisen Firefox und Safari ab, und Chrome lässt es nur mit der Erlaubnis
clipboard-writedurch.
Beides ist Absicht. Die Zwischenablage gehört dem Menschen vor dem Bildschirm, und was dort liegt, wollte er oft gerade woanders einfügen. Eine Seite, die sie ungefragt überschreibt, wäre ein Ärgernis. Eine, die sie ungefragt liest, wäre schlimmer.
Die Rückmeldung gehört dazu
Kopieren sieht man nicht. Ob es geklappt hat, merkst du erst beim Einfügen woanders. Zu jedem Kopieren-Button gehört deshalb eine kurze Bestätigung direkt daneben, und zwei Sekunden „Kopiert“ reichen.
Dazu gehört ein catch. Wird der Zugriff abgelehnt, steht dort etwas Brauchbares, etwa der Hinweis, den Text von Hand zu markieren. Ein Button, der stumm nichts tut, ist schlimmer als gar keiner.
Lesen ist noch strenger
navigator.clipboard.readText() gibt es auch, und dafür will der Browser zusätzlich ein ausdrückliches Ja. Chrome fragt um Erlaubnis. Firefox (seit Version 125) und Safari zeigen ein kleines Menü mit „Einfügen“, das erst angeklickt werden muss. Fest rechnen sollte man mit dem Lesen deshalb nie, und ein Feld, in das man selbst einfügt, funktioniert überall.
Teilen auf Mobilgeräten
<p><button id="teilen" type="button">Teilen</button></p>
<p id="rueckmeldung"></p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
} const button = document.getElementById("teilen");
const rueckmeldung = document.getElementById("rueckmeldung");
const daten = {
title: "Programmieren mit Mario",
text: "Der interaktive JavaScript-Kurs",
url: "https://mitmario.dev/lernen/javascript",
};
console.log("Gibt es navigator.share?", typeof navigator.share);
console.log("Gibt es navigator.clipboard?", typeof navigator.clipboard);
button.addEventListener("click", async () => {
// Firefox auf dem Schreibtisch kennt den Dialog nicht.
// Deshalb immer erst fragen.
if (navigator.share && navigator.canShare && navigator.canShare(daten)) {
try {
await navigator.share(daten);
rueckmeldung.textContent = "Geteilt.";
} catch (fehler) {
// Ein Abbruch durch den Nutzer ist kein Fehler.
if (fehler.name !== "AbortError") {
rueckmeldung.textContent = "Teilen hat nicht geklappt.";
}
}
return;
}
// Rückfallweg: die Adresse in die Zwischenablage. Mit
// try/catch, denn auch writeText kann abgelehnt werden, und
// dann muss der dritte Weg noch greifen.
if (navigator.clipboard) {
try {
await navigator.clipboard.writeText(daten.url);
rueckmeldung.textContent = "Adresse kopiert.";
return;
} catch (fehler) {
console.warn("Kopieren abgelehnt:", fehler.name);
}
}
// Und wenn auch das nicht geht, zeig sie wenigstens an.
rueckmeldung.textContent = daten.url;
}); navigator.share(daten) öffnet den eingebauten Teilen-Dialog des Betriebssystems mit allen installierten Apps darin. Auf einem Telefon ist das der Weg, den man dort erwartet.
Firefox auf dem Schreibtisch kennt die Funktion nicht, und wo es sie gibt, darf nicht jede Seite sie benutzen. Davor steht deshalb immer eine Prüfung und dahinter ein Rückfallweg. Erst kommt die Adresse in die Zwischenablage, und wenn auch das scheitert, steht sie sichtbar auf der Seite. Ob sich bestimmte Daten teilen lassen, prüft navigator.canShare(daten), und das wird wichtig, sobald Dateien dabei sind.
Im zweiten Beispiel läuft die ganze Kette ab, ohne Telefon. In Firefox und unter Linux antwortet typeof navigator.share mit "undefined". Chrome, Edge und Safari kennen die Funktion, aber navigator.canShare(daten) ergibt hier false, weil das Teilen in der Lektionsansicht nicht freigegeben ist. Der zweite Weg wird in Chrome und Edge abgelehnt. In der Console steht dann Kopieren abgelehnt: NotAllowedError, und am Ende steht die Adresse als Text auf der Seite. In Firefox klappt schon der zweite Weg. Ohne das try/catch um den zweiten Weg wäre in Chrome hier Schluss, mit einer leeren Rückmeldung und einem roten Eintrag in der Console.
Bricht jemand den Teilen-Dialog ab, wird das Promise mit einem Fehler namens AbortError abgelehnt. Das ist eine Entscheidung und kein Fehler, also gehört dafür auch keine Fehlermeldung auf die Seite.
Der alte Weg
<p><label for="feld">Adresse</label> <input id="feld" value="https://mitmario.dev/lernen"></p>
<p><button id="alt" type="button">Auf dem alten Weg kopieren</button></p>
<p id="rueckmeldung"></p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
}
input,
select,
textarea {
padding: 0.35rem 0.5rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
} const feld = document.getElementById("feld");
const rueckmeldung = document.getElementById("rueckmeldung");
document.getElementById("alt").addEventListener("click", () => {
// Der Weg vor der Clipboard-API: Text markieren und
// den Browser den Kopierbefehl ausführen lassen.
feld.select();
feld.setSelectionRange(0, feld.value.length);
// execCommand ist offiziell veraltet. Es arbeitet
// synchron, gibt nur true oder false zurück und kann
// nur das, was gerade markiert ist.
const geklappt = document.execCommand("copy");
rueckmeldung.textContent = geklappt ? "Kopiert, auf die alte Art." : "Auch das ging nicht.";
console.log("execCommand meldet:", geklappt);
}); Vor der Clipboard-API gab es document.execCommand("copy"). Es ist offiziell veraltet und trotzdem noch überall zu finden. Es arbeitet synchron, gibt nur true oder false zurück und kopiert ausschließlich, was gerade markiert ist, also muss vorher etwas auf der Seite markiert sein. Als Rückfall für sehr alte Umgebungen reicht es noch, für alles Neue gibt es die Clipboard-API.
In Chrome und Edge meldet der Button im ersten Beispiel, der mit der modernen API, „Kopieren hat nicht geklappt“. Der im dritten mit execCommand meldet „Kopiert, auf die alte Art“, und er hat wirklich kopiert. In Firefox kopieren hier beide.
Für den alten Weg spricht das nicht. Er hat nie um Erlaubnis gefragt und einfach kopiert, was markiert war, und deshalb ist er abgeschafft worden. Die moderne API fragt, und in Chrome bekommt sie hier ein Nein. Auf einer eigenen Seite funktioniert sie in jedem Browser, und execCommand ist laut MDN veraltet.
Zwei Sachen nehme ich daraus mit. „Funktioniert hier“ und „ist der richtige Weg“ sind verschiedene Fragen. Und eine blockierte API findet man nicht durch Umbauen, sondern durch Lesen der Meldung.
Warum diese Lektion keine Aufgabe hat
Die Seite läuft hier in einem abgeschotteten Rahmen. typeof navigator.clipboard antwortet in der Eingabezeile der Console mit "object" und window.isSecureContext mit true. An der API und am sicheren Kontext liegt es also nicht. Der Grund steht in der Meldung selbst, wenn das catch im ersten Beispiel neben fehler.name auch fehler.message ausgibt: Failed to execute 'writeText' on 'Clipboard': The Clipboard API has been blocked because of a permissions policy applied to the current document.
Die Zwischenablage ist für diesen Rahmen in der Lektionsansicht nicht freigegeben. Chrome und Edge halten sich daran. Firefox kennt diese Freigabe nicht und lässt den Klick kopieren. Es ist also eine Richtlinie, und für solche Fälle ist die zweite Hälfte einer Fehlermeldung da.
Dazu kommt noch etwas. Ein Klick, den eine Prüfung auslöst, zählt nicht als Nutzergeste. Firefox ließe ihn deshalb nicht schreiben, Chrome fehlt ohnehin die Freigabe, und eine Aufgabe ließe sich so nicht abnehmen. Eine Attrappe, die nur so tut, als würde sie kopieren, hätte keine der Bedingungen, um die es in dieser Lektion geht.
Ausprobieren kannst du alles auf deiner eigenen Seite, über den kleinen lokalen Server aus Lektion 20.5. Dort läuft die Seite in keinem fremden Rahmen, und der Kopieren-Button aus dem ersten Beispiel funktioniert in jedem Browser. Was ein Doppelklick auf die Datei erlaubt, hängt dagegen vom Browser ab.
Zum Mitnehmen
Die Zwischenablage braucht einen sicheren Kontext und einen echten Klick, und hier verweigert Chrome sie dem Rahmen ganz. Ein Kopieren-Button meldet, ob es geklappt hat, und hat einen Weg für den Fall, dass nicht.
Jetzt du
Basis Konto, kostenlosIm Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.