CKTIS / JavaScript
Navigator.clipboard — asynchrone toegang tot het klembord
Navigator.clipboard biedt een Clipboard-object voor het asynchroon lezen en schrijven van het systeemklembord. Een beveiligde context is vereist; de toegang is onderworpen aan browserbeperkingen.
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
navigator.clipboard
const text = await navigator.clipboard.readText();
await navigator.clipboard.writeText(text)Navigator.clipboard, toegankelijk via navigator.clipboard, is een alleen-lezen-eigenschap die bij herhaald uitlezen hetzelfde Clipboard-object retourneert. De eigenschap bevat niet rechtstreeks tekst: readText() retourneert een Promise met tekst, terwijl writeText(text) een Promise retourneert die na het schrijven zonder waarde wordt vervuld. read() en write() verwerken gegevens die worden weergegeven door ClipboardItem.
Dit is een Web-API, geen ECMAScript-functie; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning. Een beveiligde context en een actief document met focus zijn vereist. Machtigingen en vereisten voor gebruikersactivatie verschillen per browser: start het schrijven direct na een klik en handel afwijzingen af, waaronder NotAllowedError. Een methode detecteren garandeert geen toegang.
In tegenstelling tot ClipboardEvent.clipboardData, dat bij kopieer- en plakgebeurtenissen hoort, is deze interface asynchroon. Het klembord kan gevoelige gegevens bevatten; lees het alleen uit voor een duidelijk omschreven doel en waarschuw voordat je de inhoud vervangt.
Voorbeelden
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Navigator clipboard write</title></head>
<body>
<button type="button">Copy sample text</button>
<p role="status"></p>
<script>
const button = document.querySelector('button');
const status = document.querySelector('[role="status"]');
const clipboard = navigator.clipboard;
const canAttemptWrite = window.isSecureContext &&
typeof clipboard?.writeText === 'function';
status.textContent = canAttemptWrite
? 'Click to request a clipboard write.'
: 'Clipboard write is unavailable in this document.';
button.disabled = !canAttemptWrite;
console.log(status.textContent);
button.addEventListener('click', async () => {
try {
await clipboard.writeText('CKTIS');
status.textContent = 'Sample text copied.';
} catch (error) {
status.textContent = 'Clipboard write failed: ' + error.name;
}
});
</script>
</body>
</html>Resultaat
Before interaction, the page reports whether a user-initiated clipboard write can be attempted. If it can, clicking the button reports either success or the browser's 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.