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

CKTIS / JavaScript

DragEvent.dataTransfer — datos de arrastre

DragEvent.dataTransfer expone el objeto DataTransfer de un evento de arrastre. El acceso a sus datos depende de la fase de la operación; un evento creado mediante un script puede devolver null.

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

event.dataTransfer // DataTransfer | null

DragEvent.dataTransfer es una propiedad de solo lectura que devuelve DataTransfer o null. El navegador asocia un objeto a los eventos de arrastre nativos. En new DragEvent("drop"), dataTransfer es null de forma predeterminada; el constructor permite pasar un objeto explícito. Lo que es de solo lectura es la referencia, no todo el contenido del objeto.

En una operación de arrastre nativa, durante dragstart se pueden escribir datos con setData(). Durante drop se pueden leer con getData(), pero no modificar. En los demás eventos de esa operación, el almacén de datos está en modo protegido: se pueden comprobar los formatos mediante types, pero getData() devuelve una cadena vacía. files expone los archivos e items los elementos de datos.

Crear un evento dragover mediante un script y pasarle un nuevo objeto DataTransfer no pone el almacén en modo protegido. getData() puede seguir devolviendo los datos escritos con setData().

Para que un elemento normal acepte una acción de soltar, cancela dragover con preventDefault(). En una operación de arrastre nativa, lee los datos de forma síncrona en el controlador de drop, antes de que termine el acceso al almacén. Copia los valores necesarios antes de realizar trabajo asíncrono.

Esta es una API del navegador definida por HTML, no una función de una edición concreta de ECMAScript. Que esté disponible en Node 24 no demuestra que los navegadores la admitan. El ejemplo requiere los constructores DragEvent y DataTransfer; crear un evento mediante un script no inicia un arrastre nativo.

Ejemplos

(() => {
  const transfer = new DataTransfer();
  transfer.setData("text/plain", "CKTIS");

  const event = new DragEvent("drop", { dataTransfer: transfer });
  const emptyEvent = new DragEvent("drop");

  console.log(event.dataTransfer === transfer);
  console.log(event.dataTransfer.getData("text/plain"));
  console.log(emptyEvent.dataTransfer === null);
})();

Resultado

true
CKTIS
true

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