FileSystemWritableFileStream.truncate()
Baseline
2025
Newly 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 を返します。
例外
NotAllowedErrorDOMException-
PermissionStateが'granted'でないとき返されます。 TypeError-
sizeが定義されていないかunsigned longでないとき返されます。
例
// 未稿
仕様書
| Specification |
|---|
| File System> # api-filesystemwritablefilestream-truncate> |
ブラウザーの互換性
Loading…