File

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Интерфейс File представляет информацию о файлах и предоставляет JavaScript в веб странице доступ к их контенту.

Объекты File как правило извлекаются из объекта FileList, который возвращён как результат пользовательского выбора файлов с помощью <input> элемента, из drag and drop операций DataTransfer объекта, или из mozGetAsFile() API на HTMLCanvasElement. В Gecko, привилегированный код может создать файл представляющий любой локальный файл без пользовательского взаимодействия (см. Gecko notes для получения большей информации).

Объект File - особый вид Blob, и может быть использован в любом контексте так же, как и Blob. В частности, FileReader, URL.createObjectURL(), createImageBitmap(), и XMLHttpRequest.send() допускают и Blob, и File.

Смотри Использование файлов в веб приложениях для получения более подробной информации и примеров.

Свойства экземпляра

Интерфейс File также наследует свойства от Blob интерфейса:

File.lastModified Только для чтения

Возвращает время последнего изменения файла в миллисекунде с эпохи UNIX (1 января 1970 года в 00:00:00 в часовом поясе UTC).

File.lastModifiedDate Только для чтения

Возвращает дату последнего изменения файла, на который ссылается объект File.

File.name Только для чтения

Возвращает имя файла, на который ссылается объект File.

File.size Только для чтения

Возвращает размер файла.

File.webkitRelativePath Только для чтения

Возвращает URL адрес, где расположен File.

File.type Только для чтения

Возвращает MIME тип файла.

Методы экземпляра

Интерфейс File не определяет собственных методов, но наследует методы интерфейса Blob.

Спецификации

Specification
File API
# file-section

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также