DataTransfer.mozGetDataAt()

The DataTransfer.mozGetDataAt() method is used to retrieve an item in the drag event's data transfer object, based on a given format and index. This method returns null if the specified item does not exist or if the index is not in the range from zero to the number of items minus one.

Syntax

nsIVariant dataTransfer.mozGetDataAt([type], index);

Arguments

type

A string representing the type of the drag data to retrieve from the drag data object.

index

A unsigned long representing the index of the data to retrieve.

Return value

nsIVariant

The data item requested. If the specified item does not exist, null is returned.

Example

This example shows the use of the mozGetDataAt() method in a drop event handler.

function drop_handler(event)
{
  var dt = event.dataTransfer;
  var count = dt.mozItemCount;
  output("Items: " + count + "\n");
  for (var i = 0; i < count; i++) {
    output(" Item " + i + ":\n");
    var types = dt.mozTypesAt(i);
    for (var t = 0; t < types.length; t++) {
      output("  " + types[t] + ": "); 
      try {
        var data = dt.mozGetDataAt(types[t], i); 
        output("(" + (typeof data) + ") : <" + data + " >\n");
      } catch (ex) {
        output("<>\n");
        dump(ex);
      }   
    }   
  }
}

Specifications

This method is not defined in any Web standard.

Browser compatibility

[1]Partial support refers to not supporting .setDragImage [CanIUse.com]

See also