FileSystemDirectoryHandle.getFileHandle()

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) でのみ利用できます。

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

ブラウザーの互換性

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 2025年6月24日 by MDN contributors.

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

FileSystemDirectoryHandle.getFileHandle()

In this article

構文

引数

返値

例外

例

仕様書

ブラウザーの互換性

関連情報

Help improve MDN