Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes