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

View in English Always switch to English

FileSystemSyncAccessHandle: truncate() メソッド

Baseline
広く利用可能

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

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

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

truncate() は FileSystemSyncAccessHandle インターフェイスのメソッドで、ハンドルに対応するファイルのサイズを指定のバイト数にします。

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

構文

js
truncate(newSize)

引数

newSize

ファイルの変更後のサイズをバイト数で指定します。

返値

なし (undefined)。

例外

InvalidStateError DOMException

対応するアクセスハンドルがすでに閉じられている場合、またはファイルのバイナリーデータの変更が失敗した場合に発生します。

QuotaExceededError

newSize がファイルの元のサイズより大きく、ブラウザーのストレージ制限を超える場合に発生します。

TypeError

基盤となるファイルシステムが、ファイルサイズを新しいサイズに設定することに対応していない場合に発生します。

例

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

  // ファイルを 0 バイトに切り詰める
  accessHandle.truncate(0);

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

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

仕様書

仕様書
File System
# api-filesystemsyncaccesshandle-truncate

ブラウザーの互換性

関連情報