Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DataTransfer.setData() — memorizzare dati testuali

DataTransfer.setData() memorizza testo in un formato specificato nell’archivio dei dati di trascinamento, sostituendo il valore precedente per quel formato.

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

Sintassi

dataTransfer.setData(format, data)

DataTransfer.setData(format, data) memorizza testo, non un file. format è in genere un tipo MIME; data è una stringa. Il metodo restituisce undefined.

I formati vengono convertiti in minuscolo ASCII; text significa text/plain e url significa text/uri-list. Le scritture ripetute sostituiscono il testo dello stesso formato.

Per scrivere è necessaria la modalità di lettura/scrittura: durante il trascinamento, usa dragstart, non drop. Senza questa modalità o un archivio associato, non cambia nulla. new DataTransfer() crea un archivio scrivibile. Questa è un’API del browser, non una funzionalità ECMAScript.

Esempi

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

Risultato

second

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti