BlobBuilder

L'interface BlobBuilder fournit une manière simple de construire des objets Blob. Il suffit de créer un BlobBuilder et de lui ajouter des données  en appellant la méthode append(). Une fois finalisé, l'appel à la méthode getBlob() permet de récuperer un Blob contenant les données envoyées au constructeur dudit Blob.

Aperçu des méthodes

Méthodes

append()

Ajoute le contenu de l'objet JavaScript spécifié au Blob en construction. Si la valeur spécifiée n'est pas un Blob, un ArrayBuffer, ou une String, la valeur est forcé (coerced) à string avant d'être ajouté au blob.

void append(
  in ArrayBuffer data
);

void append(
  in Blob data
);


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

Paramètres

data

Les données à ajouter au Blob en construction.

endings

Spécifie comment les chaînes (strings) contenant des \n doivent être rendues. Cela peut être "transparent" (endings inchangés) ou "native" (les endings sont changés pour respecter la convention du système de fichier de l'OS de l'hôte). Par défault, la valeur est "transparent".

getBlob()

Retourne l'objet Blob qui a été construit en utilisant les données passées en argument des différents appels à append().

Blob getBlob(
  in DOMString contentType Facultatif
);

Paramètres

contentType Facultatif

Le type MIME des données  retournées par le Blob. Ce sera la valeur de la propriété 'type' de l'objet Blob.

Valeur de retour

Un objet Blob contenant toutes les données passées en argument de chaque appel à  append() fait depuis la création du BlobBuilder. Cela remet aussi à zéro (reset) le BlobBuilder de tel sorte que le prochain appel à append() démarre la création d'un nouveau blob vierge.

getFile()

Retourne un objet File.

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

Paramètres

name

Le nom du fichier.

contentType Facultatif

Le type MIME des données  retournées par le File. Ce sera la valeur de la propriété 'type' de l'objet File.

Valeur deretour

Un objet File.

Browser compatibility

Voir aussi

• File API Specification: BlobBuilderED
• Blob
• File