Node.js fs.futimesSync() 方法

在本文中，我们将讨论 Node.js 中的 fs.futimesSync() 方法，包括其语法、参数和示例。

Node.js 中的 fs.futimesSync() 函数是什么？

fs.futimesSync() 函数是 Node.js 的文件系统 (fs) 模块的一部分。该模块主要基于标准的 POSIX 函数 API，提供与文件系统交互的手段。通过 fs.futimesSync() 函数，我们可以同步地修改和更新给定文件描述符的访问和修改时间戳。时间戳可以指定为 Date 对象、字符串或整数。如果时间戳无法转换为有效数字，或者为 NaN、Infinity 或 -Infinity，则会显示一条消息。

概述

• 用途： fs.futimesSync() 函数可用于更改文件描述符引用的文件的文件系统时间戳。特别是，它会更改修改时间和访问时间。
• 操作阻塞： 此程序通过停止程序执行直到操作完成，充当 fs.futimes() 的同步变体。因为它在文件时间戳更新之前不会返回，所以当后续操作需要时间戳更改完成时，它可能很有用。
• 文件描述： 它与文件描述符一起工作，文件描述符是唯一标识程序会话中打开文件的数字。文件描述符可以使用 fs.openSync() 等函数获取。

语法

它具有以下语法：

参数

此方法需要三个参数

• Fd()： 需要更改时间戳的文件由文件描述符（fd）指示，这是一个整数值。
• Atime： 它表示需要设置的新访问时间戳，它可以是 Date 对象、数字或字符串。
• Mtime： mtime 对象，它可以是数字、字符串或 Date 对象，表示需要设置的新修改时间戳。

示例 1

让我们通过一个例子来说明 Node.js 中的 fs.futimesSync() 方法。

输出

 
File details before changing timestamps:
Original Modification Time: 2023-06-04T11:34:22.000Z
Original Access Time: 2023-06-04T11:34:22.000Z

File details after changing timestamps:
Updated Modification Time: 2024-06-01T10:00:00.000Z
Updated Access Time: 2024-06-01T08:00:00.000Z   

说明

在这个例子中；

• 打开文件： 首先，打开 sample_file.txt 文件，得到一个读写文件描述符。
• 获取和记录初始访问和修改时间戳： 检索并记录初始访问和修改时间。
• 通过创建新的时间戳来定义新的访问和修改时间。
• 使用 fs.futimesSync() 更新文件中的时间戳。
• 获取并记录的更改时间戳提供了最新的访问和修改时间。
• 关闭文件： 关闭文件描述符以节省资源。
• 错误处理： 记录并记录与文件交互时发生的所有错误。

示例 2

让我们通过另一个例子来说明 Node.js 中的 fs.futimesSync() 方法。

输出

 
File details before changing timestamps:
Original Modification Time: 2022-01-04T11:34:22.000Z
Original Access Time: 2022-01-04T11:34:22.000Z

File details after changing timestamps:
Updated Modification Time: 2023-11-01T16:45:00.000Z
Updated Access Time: 2023-10-01T14:30:00.000Z   

结论

总之，Node.js 的 fs.futimesSync() 函数是同步更新基于文件描述符的访问和修改时间戳的宝贵工具。此函数对于需要精确控制文件元数据（例如缓存机制、文件管理程序和备份系统）的应用程序特别有用。通过使用 fs.futimesSync() 函数，开发人员可以提高文件操作的可靠性和完整性，确保文件信息保持准确和最新。此方法的同步性质使其成为对时间一致性至关重要的场景的理想选择，因为它保证代码将在时间戳成功更新后执行。为了确保可靠的应用程序行为并防止资源泄漏，正确管理文件描述符并以周到的方式处理潜在错误非常重要。