File

File 인터페이스는 파일에 대한 정보를 제공하고, 웹 페이지의 JavaScript가 해당 내용에 접근할 수 있게 합니다.

File 객체는 일반적으로 FileList 객체에서 회수할 수 있고, FileList 객체는 사용자가 <input> 요소에서 파일을 선택했을 때, 드래그 앤 드롭 작업의 DataTransfer 객체가, 또는 HTMLCanvasElement의 mozGetAsFile() API에서 반환합니다. Gecko에서 권한 있는 코드는 사용자 상호작용 없이 모든 로컬 파일을 나타내는 File 객체를 만들 수 있습니다. (자세한 정보는 구현 참고사항을 참고하세요)

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

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

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ko/docs/Web/API/Blob" target="_top"><rect x="1" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="38.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Blob</text></a><polyline points="76,25  86,20  86,30  76,25" stroke="#D4DDE4" fill="none"/><line x1="86" y1="25" x2="116" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ko/docs/Web/API/File" target="_top"><rect x="116" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="153.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">File</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

생성자

File()

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

속성

File.lastModified Read only

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

File.lastModifiedDate Read only

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

File.name Read only

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

File.webkitRelativePath Read only

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

File이 Blob 을 구현하기 때문에 사용할 수 있는 속성도 있습니다.

File.size Read only

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

File.type Read only

File의 MIME 타입을 반환합니다.

메서드

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

Blob.slice([start[, end[, contentType]]])

소스 Blob에서 지정한 바이트 범위 만큼의 데이터를 포함하는, 새로운 Blob 객체를 반환합니다.

명세

브라우저 호환성

구현 참고사항

• Gecko와 chrome 코드에서는 이 API를 사용할 수 있습니다. 자세한 내용은 크롬 코드에서 DOM 파일 API 사용하기 를 참조하세요. 크롬코드, JSM, 부트스크랩 스코프에서 사용하려면 Cu.importGlobalProperties(['File'])를 사용하여 임포트 해야 합니다.
• Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3) 부터 권한있는 코드(extension과 같은)는 참조 할 파일을 지정하기 위해 nsIFile 객체를 DOM File 생성자에 전달할 수 있습니다.
• Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5)부터는 nsIDOMFile 객체를 직접 인스턴스화하지 않고 new File을 사용하여 XPCOM 구성요소(컴포넌트) 코드에서 File객체를 만들 수 있습니다. 생성자(컨스트럭터)는 Blob과 달리 두 번째 인수로 파일 이름을 사용합니다. 파일 이름은 임의의 문자열이 될 수 있습니다.

  new File(
    Array parts,
    String filename, 
    BlobPropertyBag properties
  );

• Gecko 7 에서는 다음과 같은 비표준 속성 및 메서드가 제거되었습니다. (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4): File.fileName, File.fileSize, File.getAsBinary(), File.getAsDataURL(), File.getAsText(string encoding) (bug 661876). 대신에 표준 속성(property)인 File.name, Blob.size, FileReader 메서드를 사용합니다.

같이 보기

• 웹 어플리케이션에서 파일 사용하기
• FileReader