Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

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écuperer 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é (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

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple8 Webkit Oui Oui — 18 Moz 110 MS Non Non
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple3 Webkit ? Oui Oui — 18 Moz 1 Non Non ?

1. Starting in Firefox 14, using MozBlobBuilder will show a warning message in the web console that the use of MozBlobBuilder is deprecated and suggests to use Blob constructor instead.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : jgroc-de
Dernière mise à jour par : jgroc-de,