KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Clipboard.write — asynchroon schrijven naar het klembord

Clipboard.write schrijft ClipboardItem-objecten naar het systeemklembord. De methode accepteert alternatieve MIME-weergaven, maar vereist een beveiligde context en toestemming van de browser.

Versie: 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, aangeroepen als navigator.clipboard.write(items), accepteert ClipboardItem-objecten. Eén item kan meerdere MIME-weergaven van dezelfde inhoud bevatten. writeText(text) is eenvoudiger voor alleen tekst. De geretourneerde promise wordt na het schrijven vervuld met undefined; geweigerde toegang kan NotAllowedError veroorzaken.

Dit is een Web API en geen onderdeel van ECMAScript; Node 24 toont niet aan dat browsers dit ondersteunen. Controleer of de API beschikbaar is en test de doelbrowsers. Gebruik een beveiligde context: HTTPS of een betrouwbare lokale oorsprong, zoals localhost. HTTPS alleen garandeert geen beveiligde context wanneer de pagina is ingebed onder een onveilige voorouder; controleer window.isSecureContext.

Voer het schrijven direct na een klik uit in een gefocust document en handel fouten af; het toestemmingsbeleid verschilt per browser. Verwar meerdere weergaven niet met meerdere items: het platform kan alleen het eerste item behouden. Het voorbeeld overschrijft het klembord na een bewuste klik van de gebruiker.

Voorbeelden

<!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>

Resultaat

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.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen