Spec-Zone.ru › Web APIs

HTMLInputElement: свойство files

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Свойство HTMLInputElement.files позволяет получить доступ к FileList, выбранным с помощью элемента <input type="file">.

Значение

Объект FileList, содержащий список выбранных файлов, или null, если элемент HTMLInputElement не соответствует типу type="file".

Примеры

В примере ниже показано, как получить доступ к свойству HTMLInputElement.files и вывести имя, дату изменения, размер и тип каждого выбранного пользователем файла.

HTML

<input id="files" type="file" multiple />

JavaScript

Обратите внимание, что HTMLInputElement.files по-прежнему возвращает экземпляр FileList, даже если файлы не выбраны. Поэтому можно безопасно перебирать его с помощью for...of без проверки наличия выбранных файлов.

const fileInput = document.getElementById("files");

console.log(fileInput.files instanceof FileList); // true even if empty

for (const file of fileInput.files) {
  console.log(file.name); // prints file name
  let fileDate = new Date(file.lastModified);
  console.log(fileDate.toLocaleDateString()); // prints legible date
  console.log(
    file.size < 1000 ? file.size : Math.round(file.size / 1000) + "KB",
  );
  console.log(file.type); // prints MIME type
}

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

Спецификация
HTML
# dom-input-files-dev

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
files 2 12 3 ≤12.1 4 18 4 ≤12.1 3 1.0 ≤37

См. также

  • DataTransfer.files

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/files

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API