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

CKTIS / JavaScript

ClipboardItem — un elemento del portapapeles con representaciones MIME

ClipboardItem describe un elemento del portapapeles que puede tener varias representaciones MIME. Su constructor prepara los datos; no los escribe por sí mismo en el portapapeles del sistema.

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

new ClipboardItem(items, options)
item.types
item.getType(type) // Promise<Blob>
ClipboardItem.supports(type)

ClipboardItem forma parte de las Web APIs, no de ECMAScript. Un objeto puede contener distintas representaciones del mismo contenido. Su constructor acepta un mapa no vacío de tipos MIME a valores Blob, cadenas o promesas de esos valores; un mapa vacío produce un TypeError.

types expone los tipos de representación y getType(type) devuelve un Promise<Blob>; si falta una representación, la promesa se rechaza con NotFoundError. La propiedad opcional presentationStyle acepta "unspecified" (valor predeterminado), "inline" o "attachment". El método estático ClipboardItem.supports(type) comprueba si se admite el formato, no los permisos.

Solo navigator.clipboard.write([item]) escribe los datos; navigator.clipboard.read() lee los elementos. El acceso al portapapeles está sujeto a restricciones de permisos, activación del usuario y foco. La interfaz requiere un contexto Window seguro. Comprueba la disponibilidad de los métodos que uses; la especificación es un borrador del W3C, y Node 24 no demuestra que haya compatibilidad en el navegador.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ClipboardItem MIME representation</title>
</head>
<body>
  <pre id="result" role="status"></pre>
  <script>
    async function showItem() {
      const result = document.querySelector('#result');
      if (typeof globalThis.ClipboardItem !== 'function') {
        result.textContent = 'ClipboardItem unavailable';
        return;
      }
      const type = 'text/plain';
      const item = new ClipboardItem({
        [type]: new Blob(['Hello'], { type })
      });
      const representation = await item.getType(type);
      result.textContent = item.types.join(', ') + '\n' + await representation.text();
    }
    showItem();
  </script>
</body>
</html>

Resultado

ClipboardItem unavailable

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