このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

FileSystemSyncAccessHandle: read() メソッド

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年3月以降、すべてのブラウザーで利用可能です。

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

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

read() は FileSystemSyncAccessHandle インターフェイスのメソッドで、ハンドルに対応するファイルの内容を指定のバッファーに読み込みます。オフセットを指定することもできます。

構文

js
read(buffer, options)

引数

buffer

ファイルの内容を読み込むバッファーを表す ArrayBuffer または(DataView などの)ArrayBufferView です。ArrayBuffer の内容を直接操作することはできないことに注意してください。かわりに、バッファーを特定のフォーマットで表す Int8Array などの型付き配列のうちの一つ、もしくは DataView のオブジェクトを作成し、それを用いてバッファーの内容を読み書きします。

options 省略可

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

at

ファイルをどこから読み込むかのバイト単位のオフセットを表す数値です。

返値

ファイルから読み込んだバイト数を表す数値です。

例外

InvalidStateError DOMException

対応するアクセスハンドルがすでに閉じられている場合に発生します。

TypeError

基盤となるファイルシステムが、指定したファイルオフセットからの読み込みに対応していない場合に発生します。

例

以下の非同期のイベントハンドラー関数は、ウェブワーカーの中にあります。メインスレッドからメッセージを受信すると、以下の動作をします。

  • 同期式アクセスハンドルを作成します。
  • ファイルのサイズを取得し、格納用の ArrayBuffer を作成します。
  • ファイルの内容をバッファーに読み込みます。
  • メッセージをエンコードし、ファイルの終端に書き込みます。
  • 変更をディスクに書き込み、アクセスハンドルを閉じます。
js
onmessage = async (e) => {
  // メインスクリプトからの処理対象のメッセージを取得する
  const message = e.data;

  // 下書きファイルのハンドルを取得する
  const root = await navigator.storage.getDirectory();
  const draftHandle = await root.getFileHandle("draft.txt", { create: true });
  // 同期式アクセスハンドルを取得する
  const accessHandle = await draftHandle.createSyncAccessHandle();

  // ファイルのサイズを取得する
  const fileSize = accessHandle.getSize();
  // ファイルの内容をバッファーに読み込む
  const buffer = new DataView(new ArrayBuffer(fileSize));
  const readBuffer = accessHandle.read(buffer, { at: 0 });

  // メッセージをファイルの終端に書き込む
  const encoder = new TextEncoder();
  const encodedMessage = encoder.encode(message);
  const writeBuffer = accessHandle.write(encodedMessage, { at: readBuffer });

  // 変更をディスクに書き込む
  accessHandle.flush();

  // 完了したら、常に FileSystemSyncAccessHandle を閉じる
  accessHandle.close();
};

メモ: 仕様書の以前のバージョンでは、close()、flush()、getSize()、truncate() は誤って非同期メソッドとして規定されていました。一部のブラウザーの古いバージョンでは、これらのメソッドがそのように実装されています。しかし、これらのメソッドに対応する現行のブラウザーでは、すべて同期メソッドとして実装されています。

仕様書

仕様書
File System
# api-filesystemsyncaccesshandle-read

ブラウザーの互換性

関連情報