← 返回首页

FileSystemFileHandle.getFile() - Web API | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

FileSystemFileHandle.getFile()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年3月.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

メモ: この機能はウェブワーカー内で利用可能です。

FileSystemFileHandle インターフェイスの getFile() メソッドは、ハンドルが表すエントリーのディスク上の状態を表す File オブジェクトで解決する Promise を返します。

このメソッドが呼び出されたあと、ディスク上のファイルが変更されたり削除されたりすると、返された File オブジェクトはおそらく読み込めなくなるでしょう。

In this article

構文

js

getFile()

引数

なし

返値

File オブジェクトで解決する Promise を返します。

例外

NotAllowedError DOMException

読み込みモードの PermissionStatus.state が granted でないとき投げられます。

NotFoundError DOMException

ファイルが見つからない場合に投げられます。

例

以下の非同期関数は、ファイルピッカーを開き、ファイルが選択されると getFile() メソッドを用いて中身を取得します。

js
async function getTheFile() {
  // ファイルピッカーを開く
  [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // ファイルの中身を取得する
  const fileData = await fileHandle.getFile();
}

仕様書

Specification

File System
# api-filesystemfilehandle-getfile

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年1月4日 by MDN contributors.

View this page on GitHub • Report a problem with this content