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

CKTIS / JavaScript

Clipboard — acceso asíncrono al portapapeles

Clipboard permite acceder al portapapeles del sistema mediante navigator.clipboard; las operaciones son asíncronas y están sujetas a restricciones de seguridad.

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

navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>

Clipboard, disponible a través de navigator.clipboard, es una interfaz de Web API, no de ECMAScript. readText() devuelve texto, writeText() escribe texto; read() y write() manejan objetos ClipboardItem. Los métodos devuelven promesas.

Se necesita un contexto seguro y que el documento tenga el foco. Los permisos y la activación del usuario pueden restringir el acceso; hacer clic no garantiza que la operación tenga éxito. Gestiona los rechazos, incluido NotAllowedError. Comprueba qué funciones están disponibles: el borrador del W3C no garantiza la compatibilidad de los navegadores, y Node 24 tampoco la demuestra.

Esto es distinto de los eventos síncronos copy, cut y paste que usan event.clipboardData. El portapapeles puede contener secretos: evita leerlo sin que se solicite. El ejemplo solo sobrescribe el portapapeles después de hacer clic.

Ejemplos

const button = document.createElement('button');
const status = document.createElement('p');
button.textContent = 'Copy CKTIS';
status.setAttribute('role', 'status');
document.body.append(button, status);

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.writeText !== 'function') {
    status.textContent = 'Clipboard unavailable';
    return;
  }

  button.disabled = true;
  try {
    await navigator.clipboard.writeText('CKTIS');
    status.textContent = 'Copied: CKTIS';
  } catch (error) {
    status.textContent = `Copy failed: ${error.name}`;
  } finally {
    button.disabled = false;
  }
});

Resultado

On an allowed, successful click: Copied: CKTIS
Clipboard text: 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