File

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

La interfaz File provee información acerca de los archivos y permite el acceso a su contenido.

Estos son generalmente recuperados através de un objeto FileList retornado como resultado de un usuario seleccionado archivos por medio de un elemento <input> , desde las operaciones drag y drop de un objeto  DataTransfer , o desde la API mozGetAsFile() en un HTMLCanvasElement. En Gecko, desde código con privilegios es posible invocar al constructor directamente con una ruta en string o una interfaz nsIFile. Vea Using the DOM File API in chrome code para mayor detalle.

La referencia al archivo puede ser almacenada cuando el formulario en enviado mientras el usuario esta desconectado, para que los datos puedan ser recuperados y subidos una vez que la conexión a Internet sea reestablecida.

Propiedades

La interfaz File también hereda propiedades de la interfaz Blob .

File.lastModifiedDate Read only
La última Date(fecha) de modificación del archivo referenciado por el objeto File .
File.name Read only
El nombre del archivo referenciado por el objeto File.
File.fileName Read only Obsoleto Gecko 7.0
El nombre del archivo referenciado por el objeto File.
File.fileSize Read only Obsoleto Gecko 7.0
El tamaño del archivo referenciado en bytes.

Métodos

La interfaz File también hereda métodosde la interfaz Blob.

File.getAsBinary() Obsoleto Gecko 7.0
Retorna un string que contiene los datos en duro del archivo en formato binario.
File.getAsDataURL() Obsoleto Gecko 7.0
Un string que contiene los datos de archivo codificados como data: URL.
File.getAsText(string encoding) Obsoleto Gecko 7.0
Retorna el contenido del archivo como un string, donde los datos del archivo son interpretados como texto usando una codificación referida.

Especificaciones

Especificación Estado Comentario
File API Working Draft Definición inicial.

Compatibilidad en Navegadores

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Soporte básico 13 3.0 (1.9) (non standard)
7 (7) (standard)
10.0 11.5 6.0
Característica Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Soporte básico Not supported 25 Not supported 11.1 6.0

Notas de Implementación

Gecko notes

  • En Gecko, puedes hacer uso de esta API desde código chrome. Vea Using the DOM File API in chrome code para mayor detalle.
  • Empezando desde Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3), código privilegiado (como las extensiones por ejemplo) puede pasar un objeto nsIFile al constructor  DOM File para especificar el archivo a referenciar.
  • Empezando desde Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), uested puede usar new File para la creación de objetos File a partir de código de componentes XPCOM en lugar de tener que instanciar el objeto nsIDOMFile directamente. El constructor toma, en contraste a Blob, un segundo argumento como nombre de archivo. El nombre de archivo puede ser cualquier String. 
    File File(
      Array parts,
      String filename, 
      BlobPropertyBag properties
    );

Código Chrome - Alcance de Disponibilidad

Para usar desde código chrome, ámbitos JSM y Bootstrap, debes importarlo de la siguiente forma:

Cu.importGlobalProperties(['File']);

URL está disponible en el ámbito Worker.

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: AshWilliams
 Última actualización por: AshWilliams,