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

  • 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 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'objet Blob.

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'objet File.

Valeur de retour

Un objet File.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi