Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / JavaScript

DataTransfer.setData() — storing text data

DataTransfer.setData() stores text in a specified format in the drag data store, replacing the previous value for that format.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

dataTransfer.setData(format, data)

DataTransfer.setData(format, data) stores text, not a file. format is usually a MIME type; data is a string. It returns undefined.

Formats are ASCII-lowercased; text means text/plain, and url means text/uri-list. Repeated writes replace text of the same format.

Writing requires read/write mode: during dragging, use dragstart, not drop. Without that mode or an associated store, nothing changes. new DataTransfer() creates a writable store. This is a browser API, not an ECMAScript feature.

Examples

const transfer = new DataTransfer();
transfer.setData("TEXT", "first");
transfer.setData("text/plain", "second");
console.log(transfer.getData("text/plain"));

Result

second

The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.

Sources