String.prototype.endsWith() 是校验文件扩展名最直接高效的方法,适合判断原始文件名是否以指定后缀结尾,需注意大小写、路径无关性,并推荐结合 MIME 类型与服务端校验。

String.prototype.endsWith() 是校验文件扩展名最直接、高效的方法之一,尤其适合判断原始文件名(如 "report.pdf" 或 "image.jpeg")是否以指定后缀结尾。
确认原始文件名结构,避免误判
原始文件名通常包含完整名称和扩展名(如 "data.csv"),但可能不含路径。若输入来自 input.files[0].name 或 URL 的 pathname,需确保未被截断或误解析:
- ✅ 正确使用:
"notes.txt".endsWith(".txt") → true - ❌ 错误示例:
"notes.txt.bak".endsWith(".txt") → false(实际是备份文件) - ⚠️ 注意大小写:
"IMAGE.PNG".endsWith(".png") → false;如需忽略大小写,先转小写再比对
支持单个或多个扩展名的灵活校验
可传入字符串或字符串数组(需自行遍历):
- 单扩展名:
filename.endsWith(".jpg") - 多扩展名(推荐封装函数):
function hasValidExt(name, exts) {<br> return exts.some(ext => name.toLowerCase().endsWith(ext.toLowerCase()));<br>}
调用:hasValidExt("Photo.JPEG", [".jpg", ".jpeg", ".png"]) → true
与正则或 split() 对比:为什么 endsWith 更合适?
校验“是否以某扩展名结尾”是典型的后缀匹配场景,不需要提取、分割或复杂模式:
- ✅
endsWith():语义清晰、性能好、无副作用、不依赖分隔符(如.可能出现在文件名中) - ❌
split('.').pop():易出错(如"my.file.txt"→"txt"看似正确,但"archive.tar.gz"→"gz"就错了) - ❌ 正则(如
/\.pdf$/i):功能过重,可读性低,且需注意转义和边界
补充建议:结合 MIME 类型做双重校验
仅靠扩展名易被伪造,生产环境建议搭配 file.type 或服务端校验:
- 前端快速过滤:
if (file.name.toLowerCase().endsWith(".xlsx")) { ... } - 同时检查:
file.type === "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" - 最终以服务端解析结果为准——扩展名只是第一道轻量防线

















