Node.js URL.fileURLToPath

在 Node.js 的 URL 模块中，有一个方法叫做 fileURLToPath。该方法用于将一个 file URL 转换成本地文件路径。在此，我们将详细介绍该 API 的用法以及注意事项，以帮助程序员更好地使用它。

用法

要使用 fileURLToPath，首先需要引入 Node.js 中的 URL 模块，如下所示：

const { fileURLToPath } = require('url');

然后，使用 fileURLToPath 将文件 URL 转换成本地文件路径，如下所示：

const fileUrl = new URL('file:///Users/username/documents/test.txt');
const filePath = fileURLToPath(fileUrl);
console.log(filePath); // /Users/username/documents/test.txt

需要注意的是，先将文件 URL 转换成 URL 对象，再传入 fileURLToPath 中进行转换。另外，不仅可以使用绝对路径，还可以使用相对路径。

const fileUrl = new URL('file://../../test.txt', 'file:///Users/username/documents/');
const filePath = fileURLToPath(fileUrl);
console.log(filePath); // /Users/test.txt

注意事项

在使用 fileURLToPath 这个 API 的时候，需要注意传入的 URL 必须是一个有效的 file URL。如果传入了一个非法的 URL，比如绝对路径和 URL 混合使用的情况，会导致错误的输出。

const fileUrl = new URL('/Users/username/documents/test.txt');
const filePath = fileURLToPath(fileUrl);
console.log(filePath); // 抛出错误：TypeError: fileUrl.protocol is not a function

因此，在使用该方法的时候，需要特别注意传入的参数是否符合要求。

总的来说，fileURLToPath 这个 API 包含了一些细节需要注意，但它依然是一个非常好用的 API，可以方便地将 file URL 转换成本地文件路径。希望本文能够帮助到大家，在程序中更好地使用此 API。