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

CKTIS / JavaScript

Clipboard.write — escritura asíncrona en el portapapeles

Clipboard.write escribe objetos ClipboardItem en el portapapeles del sistema. Admite representaciones MIME alternativas, pero requiere un contexto seguro y la autorización del navegador.

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.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);

Clipboard.write, llamada como navigator.clipboard.write(items), acepta objetos ClipboardItem. Un elemento puede contener varias representaciones MIME del mismo contenido. writeText(text) es más sencilla cuando solo se trata de texto. La promesa devuelta se cumple con undefined después de escribir; la denegación del acceso puede causar NotAllowedError.

Es una API web, no forma parte de ECMAScript; Node 24 no demuestra la compatibilidad con navegadores. Comprueba que la API esté disponible y prueba los navegadores de destino. Usa un contexto seguro: HTTPS o un origen local de confianza, como localhost. HTTPS por sí solo no garantiza un contexto seguro si la página está incrustada bajo un antecesor no seguro; comprueba window.isSecureContext.

Realiza la escritura directamente después de un clic, con el documento enfocado, y gestiona los errores; las políticas de permisos varían según el navegador. No confundas varias representaciones con varios elementos: es posible que la plataforma conserve solo el primero. El ejemplo sobrescribe el portapapeles tras un clic intencionado del usuario.

Ejemplos

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

Resultado

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.

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