Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

File

L'objet File fournit un tableau contenant des informations sur  l'accès au contenu du ou des fichiers selectionnés, des information sur le type mime la taille le nom des fichier ainsi que le nombres de fichiers selectionné. Ils sont généralement extraites d'un objet FileList retournée comme résultat lors de la sélection des fichiers en utilisant un input de type file, ou à partir d'un objet DataTransfer lors d'un glisser-déposer.

Gecko 2.0 note
(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

À partir de Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), l'objet File hérite de l'interface Blob, qui fournit des méthodes et des propriétés fournissant plus d'informations sur le fichier.

La référence de fichier peut être sauvegardé lorsque le formulaire est soumis pendant que l'utilisateur est déconnecté, afin que les données puissent être récupérées et téléchargées lorsque la connexion Internet est restauré ..

Note: The File object as implemented by Gecko offers several non-standard methods for reading the contents of the file. These should not be used, as they will prevent your web application from being used in other browsers, as well as in future versions of Gecko, which will likely remove these methods.

Method overview

DOMString getAsBinary(); Obsolète depuis Gecko 7.0
DOMString getAsDataURL(); Obsolète depuis Gecko 7.0
DOMString getAsText(in DOMString encoding); Obsolète depuis Gecko 7.0

Propriétes

!!

Property Type Description
fileName DOMString le nom du fichier courant. lecture seul. Obsolète depuis Gecko 7.0
fileSize unsigned long long la taille en bytes du fichier courant. lecture seul. Obsolète depuis Gecko 7.0
mozFullPath DOMString The full path of the referenced file; available only to code with UniversalFileRead privileges in chrome. Read only.
mozFullPathInternal DOMString C'est une propriété à usage interne uniquement qui ne fait pas de contrôles de sécurité. elle peut être utilisé qu'à partir de code natif, et est utilisé pour optimiser les performances dans des cas particuliers dans lesquels la sécurité n'est pas une préoccupation. lecture seul. Native code only!
name DOMString le nom du fichier courant. lecture seul. standard
size unsigned long long la taille en bytes du fichier courant. lecture seul. standard
type DOMString le type (MIME type) du fichier courant basé sur l'extention. lecture seul. standard
length number indique le nombre de fichier selectionné. lecture seul. standard

Methodes

Ces méthodes sont toutes non-standard. Pour lire le contenu d'un fichier, il faut utiliser l'objet standard FileReader. Voir Utilisation de fichiers issus d'applications web pour des exemples.

getAsBinary()

Obsolète depuis Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

Retourne une chaîne contenant les données du fichier au format binaire.

DOMString getAsBinary();
Parametres

None.

Valeur retourné

Une chaîne contenant le contenu binaire brut du fichier.

getAsDataURL()

Obsolète depuis Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

Retourne une chaîne contenant un ensemble de données: URL qui encode l'intégralité du contenu du fichier référencé en base64.

DOMString getAsDataURL();
Parametres

None.

Valeur  retourné

Une chaîne contenant les données du fichier codé comme un ensemble de données: URL en base64.

getAsText()

Obsolète depuis Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

Retourne le contenu du fichier en tant que chaîne dans laquelle les données du fichier est interprété comme du texte en utilisant un encodage donné.

DOMString getAsText(
  in DOMString encoding
 );
Parametres
encoding
Une chaîne indiquant le codage à utiliser pour les données renvoyées. Si cette chaîne est vide, UTF-8 est utilisé par default.
Valeur  retourné

Une chaîne contenant les données du fichier interprété comme du texte dans l'encodage spécifié.

Notes

Gecko notes

Gecko 6.0 note
(Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)

À partir de Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), l'objet File hérite de l'interface Blob, qui fournit des méthodes et des propriétés fournissant plus d'informations sur l'file.Starting dans Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3) , du code privilégié (tels que les extensions) peut passer un objet nsIFile au constructeur fichier DOM pour spécifier le fichier à référencer.

 

Specification

See also

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : teoli, tregagnon, mekal
 Dernière mise à jour par : tregagnon,