文件:lastModified 属性
注意:此功能在 Web Workers 中可用。
File 接口的只读属性 lastModified 提供文件的最后修改日期,表示自 Unix 纪元(1970 年 1 月 1 日午夜)以来的毫秒数。没有已知最后修改日期的文件将返回当前日期。
值
一个数字,表示自 Unix 纪元以来的毫秒数。
示例
下面的示例将遍历您选择的文件,并打印出每个文件是否在过去一年内被修改过。
HTML
html
<input type="file" id="file-picker" name="fileList" multiple />
<output id="output"></output>
JavaScript
js
const output = document.getElementById("output");
const filePicker = document.getElementById("file-picker");
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);
// true if the file hasn't been modified for more than 1 year
const stale = now.getTime() - file.lastModified > 31_536_000_000;
output.textContent += `${file.name} is ${
stale ? "stale" : "fresh"
} (${date}).\n`;
}
});
结果
动态创建的文件
如果文件是动态创建的,可以在 File() 构造函数中提供最后修改时间。如果缺失,lastModified 将继承 File 对象创建时 Date.now() 的当前时间。
js
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 首选项默认启用,默认为 2ms。您还可以启用 privacy.resistFingerprinting,在这种情况下,精度将是 100ms 或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值(以较大者为准)。
例如,在时间精度降低的情况下,someFile.lastModified 的结果将始终是 2 的倍数,或者在启用 privacy.resistFingerprinting 时是 100(或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds)的倍数。
js
// reduced time precision (2ms) in Firefox 60
someFile.lastModified;
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// …
// reduced time precision with `privacy.resistFingerprinting` enabled
someFile.lastModified;
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// …
规范
| 规范 |
|---|
| File API # dfn-lastModified |
浏览器兼容性
加载中…