BlobBuilder

Obsolète

Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.

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écupérer un Blob contenant les données envoyées au constructeur dudit Blob.

Note: L'interface BlobBuilder est désormais déconseillé (deprecated) au profit du nouveau constructeur Blob.

Aperçu des méthodes

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);

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ée (coerced) à string avant d'être ajoutée 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() depuis la création du BlobBuilder. Cela remet aussi à zéro (reset) le BlobBuilder de tel sorte que le prochain appel à append() démarrera la création d'un nouveau blob vierge.

getFile() Cette API n'a pas été standardisée.

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

BCD tables only load in the browser

Voir aussi