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.
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'objetBlob
.
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()
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'objetFile
.
Valeur deretour
Un objet File
.
Browser compatibility
BCD tables only load in the browser