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.
À 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é ..
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
À 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
- File upload state (HTML 5 working draft)
See also
- Using files from web applications
- Using the DOM File API in chrome code
- Filelist
FileReader- bug 523771 - Support <input type=file multiple>