Obsoleto
Esta funcionalidad es obsoleta. Aunque puede aún funcionar en algunos navegadores, se desalienta su uso ya que puede ser removida en cualquier momento. Evite usarla.

La interfaz BlobBuilder provee 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.

Nota: La interfaz BlobBuilder ha sido descontinuada en favor de introducir el constructor mas reciente Blob.

Información general de los metodos

void append(in ArrayBuffer data);
void append(in Blob data);
void append(in String data, [optional] in String endings);
Blob getBlob([optional] in DOMString contentType);
File getFile(in DOMString name, [optional] in DOMString contentType);

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 serán escritas las cadenas que contienen  \n. 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()

Retorna 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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (soporte básico) 8[1] Sin soporte[2] 10[3] Sin soporte Sin soporte[1]
getfile() Sin soporte Sin soporte Sin soporte Sin soporte Sin soporte
Característica Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (soporte básico) 3[1] Sin soporte[2] Sin soporte Sin soporte Sin soporte[1]
getfile() Sin soporte Sin soporte Sin soporte Sin soporte Sin soporte

[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.

Vea también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: BrodaNoel, japho
 Última actualización por: BrodaNoel,