Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

DataTransfer.setData() — stocker des données textuelles

DataTransfer.setData() stocke du texte dans un format donné dans le magasin de données de glisser-déposer, en remplaçant la valeur précédente de ce 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

Syntaxe

dataTransfer.setData(format, data)

DataTransfer.setData(format, data) stocke du texte, pas un fichier. format est généralement un type MIME ; data est une chaîne de caractères. La méthode renvoie undefined.

Les formats sont convertis en minuscules ASCII ; text signifie text/plain et url signifie text/uri-list. Les écritures répétées remplacent le texte du même format.

L’écriture nécessite le mode lecture/écriture : pendant le glissement, utilisez dragstart, et non drop. Sans ce mode ou sans magasin associé, rien ne change. new DataTransfer() crée un magasin inscriptible. Il s’agit d’une API de navigateur, et non d’une fonctionnalité ECMAScript.

Exemples

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

Résultat

second

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources