CKTIS / JavaScript
DataTransfer.setData() — zapis danych tekstowych
DataTransfer.setData() zapisuje tekst określonego formatu w magazynie przeciągania, zastępując wcześniejszą wartość tego formatu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
dataTransfer.setData(format, data)DataTransfer.setData(format, data) zapisuje tekst, nie plik. format zwykle jest typem MIME, a data — ciągiem znaków. Metoda zwraca undefined.
Format jest normalizowany do małych liter ASCII; text oznacza text/plain, a url — text/uri-list. Ponowny zapis zastępuje tekst tego samego formatu.
Zapis wymaga trybu odczytu/zapisu: podczas przeciągania użyj dragstart, nie drop. Bez tego trybu lub powiązanego magazynu metoda nic nie zmienia. Konstruktor new DataTransfer() tworzy zapisywalny magazyn. To API przeglądarki, nie funkcja ECMAScript.
Przykłady
const transfer = new DataTransfer();
transfer.setData("TEXT", "first");
transfer.setData("text/plain", "second");
console.log(transfer.getData("text/plain"));Wynik
second
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.