Файл: Конструктор File()

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

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

Примечание: Эта функция доступна в Веб-воркерах.

Конструктор File() создаёт новый экземпляр объекта File.

Синтаксис

new File(fileBits, fileName)
new File(fileBits, fileName, options)

Параметры

fileBits

Объект итерируемый, такой как массив, содержащий объекты ArrayBuffer, объекты TypedArray, объекты DataView, объекты Blob, строки или их комбинацию, которые будут помещены в File. Обратите внимание, что здесь строки закодированы в UTF-8, в отличие от обычных строк JavaScript, которые закодированы в UTF-16.

fileName

Строка, представляющая имя файла или путь к файлу.

options Необязательно

Объект параметров, содержащий необязательные атрибуты для файла. Доступные параметры:

type Необязательно: Строка, представляющая MIME-тип содержимого, которое будет помещено в файл. По умолчанию значение "".
endings Необязательно: Как интерпретировать символы новой строки (\n) в содержимом, если данные являются текстовыми. Значение по умолчанию, transparent, копирует символы новой строки в Blob без изменений. Чтобы преобразовать символы новой строки в стандартную нативную конвенцию хостовой системы, укажите значение native.
lastModified Необязательно: Число, представляющее количество миллисекунд между эпохой Unix и временем последнего изменения файла. По умолчанию используется значение Date.now().

Примеры

const file = new File(["foo"], "foo.txt", {
  type: "text/plain",
});

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

Спецификация
API файлов # file-constructor

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`File`	38	79	28	25	10.1	38	28	25	10.3	3.0	38

См. также

© 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/File/File