File: lastModified プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
メモ: この機能はウェブワーカー内で利用可能です。
lastModified は File インターフェイスの読み取り専用プロパティで、ファイルの最終更新日時を UNIX 元期（1970 年 1 月 1 日の深夜 0 時）からのミリ秒数で返します。最終更新日時が分からないファイルは、現在の日時を返します。
値
UNIX 元期からのミリ秒数を表す数値です。
例
下記の例では、選んだファイルをループして、それぞれのファイルが過去 1 年以内に変更されたかどうかを出力します。
HTML
<input type="file" id="filepicker" name="fileList" multiple />
<output id="output"></output>
JavaScript
const output = document.getElementById("output");
const filepicker = document.getElementById("filepicker");
filepicker.addEventListener("change", (event) => {
const files = event.target.files;
const now = new Date();
output.textContent = "";
for (const file of files) {
const date = new Date(file.lastModified);
// ファイルが 1 年以上変更されていなければtrue
const stale = now.getTime() - file.lastModified > 31_536_000_000;
output.textContent += `${file.name} is ${
stale ? "stale" : "fresh"
} (${date}).\n`;
}
});
結果
動的に生成されるファイル
ファイルが動的に生成された場合、最終更新日時は new File() コンストラクター関数で指定することができます。ファイルが見つからない場合、 lastModified は File オブジェクトの作成時に Date.now() から現在の時刻を継承します。
const fileWithDate = new File([], "file.bin", {
lastModified: new Date(2017, 1, 1),
});
console.log(fileWithDate.lastModified); // returns 1485903600000
const fileWithoutDate = new File([], "file.bin");
console.log(fileWithoutDate.lastModified); // returns current time
時間の精度の低下
タイミング攻撃やフィンガープリンティングに対する保護機能を提供するために、 someFile.lastModified の精度がブラウザーの設定に応じて丸められることがあります。
Firefox では、privacy.reduceTimerPrecision 設定は既定で有効になっており、既定で 2 ミリ秒になります。この場合、精度は 100ms または privacy.resistFingerprinting.reduceTimerPrecision.microseconds の値のどちらか大きい方になります。
例えば、時刻の精度を下げた場合、someFile.lastModified の結果は常に 2 の倍数になり、privacy.resistFingerprinting を有効にした場合は 100 の倍数（または privacy.resistFingerprinting.reduceTimerPrecision.microseconds）になります。
// Firefox 60 での時間の制度の低下 (2ms)
someFile.lastModified;
// 取りうる値:
// 1519211809934
// 1519211810362
// 1519211811670
// …
// `privacy.resistFingerprinting` が有効な場合の時間の制度の低下
someFile.lastModified;
// 取りうる値:
// 1519129853500
// 1519129858900
// 1519129864400
// …
仕様書
| Specification |
|---|
| File API # dfn-lastModified |