Node.js 中的 path.extname() 函数

2025 年 4 月 29 日 | 4 分钟阅读

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

Node.js 中的 path.extname() 函数是什么？

Node.js 中的 path.extname() 方法是内置 path 模块的一部分。它用于从给定的文件路径中获取文件的扩展名。这个字符串组件以最后一个点 (.) 开始，包括该点本身。这部分被称为文件名部分。这些函数使用扩展名来确定文件的类型。如果存在扩展名（例如 .txt），它将返回一个包含前导点的字符串；否则，它将返回一个空字符串。此功能有助于处理文件上传等操作，例如验证文件扩展名或识别文件类型。它会忽略查询字符串和 URL 片段，并且支持 Unix (/) 和 Windows (\) 路径格式。Path.extname('file.tar.gz') 返回 .gz。它易于使用，非常适合需要文件处理或 MIME 类型识别的应用程序。

语法

它具有以下语法：

参数

路径： 字符串路径是文件的路径。该路径可以是绝对路径或相对路径。

返回值

此字符串包含文件扩展名和前导点 (.). 如果没有文件扩展名或路径的最后一个字符是点 (.)，则返回空字符串 ("")。

要点

它与 Windows (\) 和 Unix (/) 样式的路径分隔符兼容。
URL 片段和查询字符串将被忽略。

示例 1

让我们通过一个例子来说明 Node.js 中的 path.extname() 函数。

 
const path = require('path');

// Example with a full file path
const filePath1 = '/usr/local/bin/script.js';
console.log(path.extname(filePath1)); // Output: .js

// Example with a Windows-style path
const filePath2 = 'C:\\Program Files\\app\\data.json';
console.log(path.extname(filePath2)); // Output: .json

// Example with no file extension
const filePath3 = '/home/user/readme';
console.log(path.extname(filePath3)); // Output: ''

// Example with a hidden file (starts with a dot)
const filePath4 = '.env';
console.log(path.extname(filePath4)); // Output: ''

// Example with a query string in a URL-like string
const filePath5 = 'https://example.com/image.png?size=large';
console.log(path.extname(filePath5)); // Output: .png

// Example with multiple dots in the filename
const filePath6 = 'archive.backup.tar.gz';
console.log(path.extname(filePath6)); // Output: .gz   

输出

 
.js
.json


.png?size=large
.gz

说明

标准文件路径： 如预期，它会提取扩展名 (.js,.json)。
隐藏文件： 后缀为“.env”的文件不被视为具有扩展名。
URL： 只提取文件扩展名，查询字符串将被忽略。
多个点： 扩展名仅被视为最后一个点之后的部分。

要点

扩展名被认为从文件名中的最后一个点开始。
在文件上传处理、MIME 类型识别或日志记录等应用程序中使用 path.extname() 函数进行文件类型检查和验证。

示例 2

让我们通过另一个例子来说明 Node.js 中的 path.extname() 函数。

 
const path = require('path');

// Array of file names
const files = [
  'document.pdf',
  'photo.jpg',
  'archive.zip',
  'script.js',
  'README',
  '.gitignore',
  'video.mp4',
  'notes.docx'
];

// Function to filter files by extension
function filterFilesByExtension(files, extension) {
  return files.filter(file => path.extname(file) === extension);
}

// Get all `.js` files
const jsFiles = filterFilesByExtension(files, '.js');
console.log('JavaScript Files:', jsFiles); // Output: [ 'script.js' ]

// Get all `.jpg` files
const jpgFiles = filterFilesByExtension(files, '.jpg');
console.log('Image Files:', jpgFiles); // Output: [ 'photo.jpg' ]

// Get all `.pdf` files
const pdfFiles = filterFilesByExtension(files, '.pdf');
console.log('PDF Files:', pdfFiles); // Output: [ 'document.pdf' ]

// Get files without an extension
const noExtensionFiles = files.filter(file => path.extname(file) === '');
console.log('Files Without Extension:', noExtensionFiles); // Output: [ 'README' ]   

输出

 
JavaScript Files: [ 'script.js' ]
Image Files: [ 'photo.jpg' ]
PDF Files: [ 'document.pdf' ]
Files Without Extension: [ 'README', '.gitignore' ]

说明

文件列表： 它包含各种文件，有和没有扩展名的都有。
过滤逻辑： filterFilesByExtension() 函数利用 path.extname() 来匹配具有特定扩展名的文件。
结果： 最终效果是列出没有扩展名的文件，并根据其扩展名过滤文件。

结论

总而言之，Node.js 的 path.extname() 方法在处理文件扩展名时提供了一个强大的解决方案。因为它有助于从特定文件路径中提取扩展名，所以在文件验证、分类和 MIME 类型识别等场景中非常有用。该函数支持 Unix 和 Windows 文件路径格式，并能优雅地处理边缘情况，包括隐藏文件、没有扩展名的文件以及带有查询字符串的 URL。通过利用其功能，开发人员可以有效地管理与文件相关的操作，从而提高处理或处理各种文件类型的应用程序的控制力和可靠性。

下一主题Node.js 中的 os-userinfo-options 函数

Node.js 中的 path.extname() 函数