このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
FileSystemWritableFileStream.truncate()
Baseline 2025Newly available
Since September 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
FileSystemWritableFileStream インターフェイスのtruncate() メソッドは、ストリームに対応するファイルのサイズを指定のバイト数にします。
指定したサイズがファイルの現在のサイズより大きい場合、ファイルの拡張部分はnull のバイトで埋めます。そうでない場合、ファイルを切り詰めます。
truncate() が呼ばれると、ファイルカーソルも移動します。オフセットがサイズより小さい場合、変化しません。オフセットがサイズより大きい場合、オフセットがサイズに設定されます。これにより、この後の書き込みがエラーにならないようにします。
ストリームが閉じられるまで、変更はディスク上の実際のファイルには一切書き込まれません。通常、変更はかわりに一時ファイルに書き込まれます。
構文
truncate()引数
- size
ストリームの新しいバイト数を表す
unsigned long値です。
返値
undefined で解決するPromise を返します。
例外
NotAllowedErrorDOMExceptionPermissionStateが'granted'でないとき返されます。TypeErrorsizeが定義されていないかunsigned longでないとき返されます。
例
// 未稿仕様書
| Specification |
|---|
| File System # api-filesystemwritablefilestream-truncate |