CKTIS / JavaScript
Clipboard.writeText — escribir texto en el portapapeles
Clipboard.writeText escribe texto sin formato en el portapapeles del sistema. La operación es asíncrona y requiere un contexto seguro y permiso del navegador para escribir.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
await navigator.clipboard.writeText(text);Clipboard.writeText, llamada como navigator.clipboard.writeText(text), reemplaza el contenido del portapapeles por texto sin formato, no por HTML. Devuelve una Promise que se cumple con undefined una vez realizada la escritura.
Se requiere un contexto seguro y un documento activo con el foco. Llama al método directamente desde una acción de clic; la activación del usuario no garantiza el permiso. Si se deniega el permiso, la promesa puede rechazarse con NotAllowedError.
Usa await y try...catch; indica que la operación se ha realizado correctamente solo cuando se cumpla la promesa. Comprueba la disponibilidad de la API en el navegador de destino: Node 24 en el repositorio no demuestra que sea compatible con navegadores.
Ejemplos
const button = document.createElement('button');
button.type = 'button';
button.textContent = 'Copy CKTIS';
const status = document.createElement('p');
status.setAttribute('role', 'status');
document.body.append(button, status);
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.writeText !== 'function') {
status.textContent = 'Unavailable';
return;
}
try {
await navigator.clipboard.writeText('CKTIS');
status.textContent = 'Copied: CKTIS';
} catch (error) {
status.textContent = `Copy failed: ${error.name}`;
}
});Resultado
Copied: CKTIS
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.