Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

DataTransfer.setData() — armazenar dados de texto

DataTransfer.setData() armazena texto num formato especificado no armazenamento de dados de arrastamento, substituindo o valor anterior desse formato.

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

Sintaxe

dataTransfer.setData(format, data)

DataTransfer.setData(format, data) armazena texto, não um ficheiro. format é normalmente um tipo MIME; data é uma cadeia de caracteres. O método devolve undefined.

Os formatos são convertidos para minúsculas ASCII; text significa text/plain e url significa text/uri-list. Escritas repetidas substituem o texto do mesmo formato.

Para escrever, é necessário o modo de leitura/escrita: durante o arrastamento, use dragstart, não drop. Sem esse modo ou sem um armazenamento associado, nada muda. new DataTransfer() cria um armazenamento onde é possível escrever. Esta é uma API do navegador, não uma funcionalidade de ECMAScript.

Exemplos

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

Resultado

second

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes