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 객체가 포함한 것을 사용하게 됩니다. FileList 객체는 사용자가 <input> 요소로 파일을 선택한 결과 값으로, 또는 드래그 앤 드롭 작업의 DataTransfer 객체에서 가져올 수 있습니다.

File 객체는 Blob의 한 종류로, Blob을 사용할 수 있는 모든 맥락에서 사용할 수 있습니다. 특히 FileReader, URL.createObjectURL(), createImageBitmap(), XMLHttpRequest.send()BlobFile을 모두 허용합니다.

자세한 정보 및 예제는 웹 애플리케이션에서 파일 사용하기를 참고하세요.

Blob File

생성자

File()

새로 생성한 File을 반환합니다.

속성

File.prototype.lastModified 읽기 전용

파일의 최종 수정 시간을 UNIX 시간(1970년 1월 1일 자정)과의 밀리초 차이로 반환합니다.

File.prototype.lastModifiedDate 지원이 중단되었습니다 읽기 전용

File 객체가 참조하는 파일의 마지막 수정 시간을 Date로 반환합니다.

File.prototype.name 읽기 전용

File 객체가 참조하는 파일의 이름을 반환합니다.

File.prototype.webkitRelativePath 비표준 읽기 전용

File의 URL 상대경로를 반환합니다.

FileBlob을 구현하므로 다음 속성도 가집니다.

File.prototype.size 읽기 전용

File의 크기를 바이트 단위로 반환합니다.

File.prototype.type 읽기 전용

FileMIME 유형을 반환합니다.

메서드

File 인터페이스는 메서드를 정의하지 않지만, Blob 인터페이스에서 메서드를 상속합니다.

Blob.prototype.slice()

지정한 바이트 범위 만큼 소스 Blob의 데이터를 복사한 새로운 Blob 객체를 반환합니다.

Blob.prototype.stream()

FileReadableStream으로 변환합니다. ReadableStream은 파일 내용을 읽을 때 사용할 수 있습니다.

Blob.prototype.text()

File을 스트림으로 변환한 후 끝까지 읽습니다. 문자열로 이행하는 Promise를 반환합니다.

Blob.prototype.arrayBuffer()

File을 스트림으로 변환한 후 끝까지 읽습니다. ArrayBuffer로 이행하는 Promise를 반환합니다.

명세

Specification
File API
# file-section

브라우저 호환성

BCD tables only load in the browser

같이 보기