Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła