FileSystemFileHandle: getFile() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年3月以降、すべてのブラウザーで利用可能です。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
メモ: この機能はウェブワーカー内で利用可能です。
getFile() は FileSystemFileHandle インターフェイスのメソッドで、ハンドルが表す項目のディスク上の状態を表す File オブジェクトで解決する Promise を返します。
このメソッドが呼び出されたあと、ディスク上のファイルが変更されたり削除されたりすると、返された File オブジェクトはおそらく読み込めなくなるでしょう。
構文
js
getFile()
引数
なし。
返値
例外
NotAllowedErrorDOMException-
readモードのPermissionStatus.stateがgrantedでないとき発生します。 NotFoundErrorDOMException-
ファイルが見つからない場合に発生します。
例
以下の非同期関数は、ファイルピッカーを開き、ファイルが選択されると getFile() メソッドを用いて中身を取得します。
js
async function getTheFile() {
// ファイルピッカーを開く
const [fileHandle] = await window.showOpenFilePicker(pickerOpts);
// ファイルの中身を取得する
const fileData = await fileHandle.getFile();
}
仕様書
| 仕様書 |
|---|
| File System # api-filesystemfilehandle-getfile |