FileSystemDirectoryHandle.getFileHandle()

Baseline 2023
Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

FileSystemDirectoryHandle インターフェイスの getFileHandle() メソッドは、メソッドが呼ばれたディレクトリー内の指定した名前のファイルを表す FileSystemFileHandle を返します。

構文

js
getFileHandle(name)
getFileHandle(name, options)

引数

name

取得したいファイルの FileSystemHandle.name を表す文字列です。

options 省略可

以下のプロパティを持つオブジェクトです。

create

Boolean です。デフォルトは false です。 true に設定すると、ファイルが見つからない場合、指定した名前のファイルが作成されて返されます。

返値

FileSystemFileHandle で解決する Promise を返します。

例外

NotAllowedError DOMException

PermissionStatus'granted' でないとき投げられます。

TypeError

指定された名前が有効な文字列でないか、ネイティブのファイルシステムで支障が出る文字を含むとき投げられます。

TypeMismatchError DOMException

指定されたエントリーがディレクトリーであってファイルではないとき投げられます。

NotFoundError DOMException

ファイルが存在せず、create オプションが false に設定されているとき投げられます。

以下の例では、指定の名前のファイルハンドルを返します。ファイルが存在しない場合、作成されます。

js
const fileName = "fileToGetName";

// ディレクトリーハンドル 'currentDirHandle' があると仮定
const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true });

仕様書

Specification
File System
# api-filesystemdirectoryhandle-getfilehandle

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getFileHandle

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報