このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
FileSystemSyncAccessHandle.truncate()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年3月以降、すべてのブラウザーで利用可能です。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
FileSystemSyncAccessHandle インターフェイスの truncate() メソッドは、ハンドルに対応するファイルのサイズを指定のバイト数にします。
構文
js
truncate(newSize)
引数
newSize-
ファイルのリサイズ後のバイト数です。
返値
undefined で解決する Promise を返します。
例外
InvalidStateErrorDOMException-
対応するアクセスハンドルが既に閉じられているか、ファイルのバイナリーデータの変更が失敗したとき投げられます。
QuotaExceededErrorDOMException-
newSizeがファイルのもとのサイズより大きく、ブラウザーのストレージ制限を超えるとき投げられます。
例
js
async function truncateFile() {
// draft ファイルのハンドルを取得する
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 |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。