BlobBuilder
Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.
Note : L'interface BlobBuilder
a été dépréciée pour être remplacée par le constructeur Blob
.
L'interface BlobBuilder
fournit une méthode simple pour construire des objets Blob
. Pour cela, on créera un objet BlobBuilder
et on ajoutera des fragments de données en appelant la méthode append()
. Une fois qu'on a terminé de construire le blob, on peut appeler getBlob()
afin de récupérer l'objet Blob
qui contient les données fournies au constructeur de blob.
Aperçu des méthodes
Méthodes
append()
Ajoute le contenu de l'objet JavaScript indiqué à l'objet Blob
en cours de construction. Si la valeur fournie n'est pas un Blob
, ArrayBuffer
, ou une chaîne de caractères String
, la valeur est convertie en une chaîne de caractères 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 à l'objet
Blob
en cours de construction. endings
-
Indique la façon dont les chaînes de caractères contenant
\n
doivent être écrites. La valeur de cet argument peut être"transparent"
(les fins de lignes ne sont pas modifiées) ou"native"
(les fins de lignes sont modifiées afin de correspondre à la convention utilisée par le système de fichier du système d'exploitation). La valeur par défaut est"transparent"
.
getBlob()
Renvoie l'objet Blob
qui a été construit avec les données ajoutées lors des appels successifs à append()
.
Blob getBlob(
in DOMString contentType // facultatif
);
Paramètres
contentType
Facultatif-
Le type MIME des données à renvoyer dans l'objet
Blob
. Cette valeur sera utilisée pour la propriététype
de l'objetBlob
.
Valeur de retour
Un objet Blob
qui contient l'ensemble des données passées lors des appels à append()
depuis la construction de l'objet BlobBuilder
. Cette méthode réinitialise également l'objet BlobBuilder
courant afin que le prochain appel à append()
démarre la création d'un nouveau blob.
getFile()
Non-Standard
Renvoie un nouvel 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 à renvoyer dans l'objet
File
. Cette valeur sera utilisée pour la valeur de la propriététype
de l'objetFile
.
Valeur de retour
Un objet File
.
Compatibilité des navigateurs
BCD tables only load in the browser