Esempio con gli appunti

Questo esempio mostra come copiare del testo negli appunti. È tratto dall'esempio Copy / Paste data dell'applicazione di esempio Ninext.

function copyToClipboard(text : text) do
    #{ navigator.clipboard.writeText(text) }#
end;

Il blocco non porta alcuna annotazione di tipo: agisce senza restituire nulla. Un'annotazione come :text annuncerebbe un valore, da restituire con return; a partire dalla versione 3.2.0, la scheda Errori segnala un blocco tipizzato che non restituisce nulla.

Restrizioni d'uso di navigator.clipboard.writeText()

L'API navigator.clipboard.writeText(text) è soggetta a restrizioni di sicurezza imposte dai browser. Deve essere attivata direttamente da un'interazione dell'utente (per esempio il clic su un pulsante).

Se tra l'interazione dell'utente e la chiamata a writeText() interviene un ritardo o un'elaborazione intermedia (per esempio un calcolo), il browser non considera più l'operazione come avviata dall'utente e blocca l'accesso agli appunti per prevenire abusi.

Esempio corretto:

document.getElementById("copyButton").addEventListener("click", () => {
    navigator.clipboard.writeText("Copied text!")
        .then(() => console.log("Text copied successfully!"))
        .catch(err => console.error("Error copying text:", err));
});

Esempio errato (può non funzionare):

document.getElementById("copyButton").addEventListener("click", () => {
    setTimeout(() => { // Introducing a delay may prevent copying
        navigator.clipboard.writeText("Copied text!");
    }, 100);
});