BlobBuilder

La interfaz BlobBuilder proveé una manera fácil de construir objetos Blob . Solo crea un BlobBuilder y anexa trozos de datos invocando  el método append() . Cuando termines de construir tu objeto, llama al método getBlob() para obtener un objeto  Blob  que contiene los datos que le enviaste al blob builder.

Información general de los metodos

Metodos

append()

Anexa el contenido del objeto javascript especificado al Blob que esta siendo construido. Si el valor especificado no es  un  Blob, ArrayBuffer, o String, el valor es convertido a String antes de ser anexado al  blob.

void append(
  in ArrayBuffer data
);

void append(
  in Blob data
);


void append(
  in String data,
  [optional] in String endings
);

Parametros

data

Los datos a anexar al objeto Blob que esta siendo construido.

endings

Establece como las cadenas que contienen  \n seran escritas. Puede ser "transparent" (los finales no cambian) o "native" (los finales cambian para coincidir  a conveniencia del sistema operativo anfitrión). El valor predeterminado es "transparent".

getBlob()

Regresa el objeto  Blob que ha sido construido usando los datos pasados atraves del método append().

Blob getBlob(
  in DOMString contentType Optional
);

Parametros

contentType Optional

El tipo MIME de los datos que seran regresados en el objeto Blob. Esto será la propiedad tipo (Type) de los objetos Blob.

Valor de Retorno

Un objeto  Blob conteniendo todos los datos pasados por cualquier llamada hecha  al método append() desde que el  BlobBuilder fue creado. Esto tambien reinicializa el  BlobBuilder sí que la siguiente llamada al metodo append() es empezar de nuevo , un blob vacio.

getFile()

Regresa un objeto File.

File getFile(
  in DOMString name,
  [optional] in DOMString contentType
); 

Parametros

name

El nombre del archivo.

contentType Optional

El tipo MIME de dats regresados en el objeto File. Este será el valor de la propiedad tipo (type) del objeto File.

Valor de Retorno

Un Objeto File.

Compatibilidad con Nevegadores

[1] WebKit implementa el API como WebKitBlobBuilder, aunque es obsoleta ahora y ha hecho su soporte configurable. Actualmente Safari deshabilita esta caracteristica  en Nightly, asi que probablemente no venga en la version final. Por otra parte, Chrome, que lo ha soportado desde Chrome 8, mantiene disponible esta caracteristica. Asi que Chrome podrá continuar soportando esta caracteristica. (Visita WebKit changeset para mas detalles).

[2] Gecko implementa el API como MozBlobBuilder. Empezando con Firefox 14, usando MozBlobBuilder mostrará un mensaje de advertencia en la consola de que usar MozBlobBuilder es obsoleto y se sugiere usar el constructor  Blob en su lugar. En Gecko 18.0 esta caracteristica fue removida..

[3] Trident implementa el API como MSBlobBuilder.

Mira también

• File API Specification: BlobBuilderED
• Blob
• File