文件类型检测神器：file-type 完全使用手册

在现代软件开发中，精准的文件类型识别是基础而关键的需求。file-type 作为一款强大的开源工具，专门用于高效检测文件、数据流和缓冲区的真实格式。它通过分析文件开头的魔数标识符来准确判断文件类型，完美支持图片、视频、音频等主流格式的识别。

项目概述

file-type 是一个基于魔数检测的文件类型识别库，能够快速准确地识别超过200种常见的文件格式。该项目采用先进的魔数检测算法，支持多种输入方式，包括本地文件路径、Buffer 数据和实时流数据，全面兼容 Node.js 和浏览器环境。

核心功能特性

多格式支持

file-type 支持检测包括图片格式（PNG、JPEG、GIF、WebP等）、视频格式（MP4、AVI、MKV等）、音频格式（MP3、FLAC、WAV等）、文档格式（PDF、DOCX、XLSX等）在内的各类二进制文件格式。

多种输入方式

• 文件路径检测：直接通过文件路径进行类型识别
• 缓冲区检测：通过 Buffer 或 Uint8Array 数据进行识别
• 流数据检测：支持实时流数据的类型识别
• Blob 对象检测：在浏览器环境中支持 Blob 对象的类型识别

环境兼容性

file-type 完美支持 Node.js 和浏览器双环境，提供统一的 API 接口，方便在不同环境中使用。

快速开始

安装

npm install file-type

基础使用示例

从文件路径检测类型：

import {fileTypeFromFile} from 'file-type';

const result = await fileTypeFromFile('example.png');
console.log(result); // {ext: 'png', mime: 'image/png'}

从缓冲区检测类型：

import {fileTypeFromBuffer} from 'file-type';
import {readChunk} from 'read-chunk';

const buffer = await readChunk('example.mp3', {length: 4100});
const fileType = await fileTypeFromBuffer(buffer);
console.log(fileType); // {ext: 'mp3', mime: 'audio/mpeg'}

从流数据检测类型：

import fs from 'node:fs';
import {fileTypeFromStream} from 'file-type';

const stream = fs.createReadStream('example.mp4');
const result = await fileTypeFromStream(stream);
console.log(result); // {ext: 'mp4', mime: 'video/mp4'}

高级功能

自定义检测器

file-type 支持通过自定义检测器来扩展检测能力。用户可以编写自己的检测器来处理特定的文件格式需求。

自定义检测器示例：

import {FileTypeParser} from 'file-type';

const unicornDetector = {
  async detect(tokenizer) {
    const unicornHeader = [85, 78, 73, 67, 79, 82, 78]; // "UNICORN" in ASCII decimal
    const buffer = new Uint8Array(unicornHeader.length);
    await tokenizer.peekBuffer(buffer, {length: unicornHeader.length, mayBeLess: true});
    if (unicornHeader.every((value, index) => value === buffer[index])) {
      return {ext: 'unicorn', mime: 'application/unicorn'};
    }
    return undefined;
  }
}

const parser = new FileTypeParser({customDetectors: [unicornDetector]});
const fileType = await parser.fromBuffer(buffer);

支持的文件格式

file-type 支持检测的文件格式种类繁多，包括但不限于：

• 图像格式：PNG、JPEG、GIF、WebP、BMP、TIFF、HEIC等
• 视频格式：MP4、AVI、MKV、MOV、WebM等
• 音频格式：MP3、FLAC、WAV、AAC、OGG等
• 文档格式：PDF、DOCX、XLSX、PPTX等
• 压缩格式：ZIP、RAR、7Z、TAR、GZ等

实际应用场景

文件上传验证

在用户上传文件时，使用 file-type 实时检测文件格式，确保上传内容安全合规，防止恶意文件上传。

流媒体处理

在处理视频流、音频流数据时，实时识别数据格式，保证媒体处理流程顺畅，避免格式错误导致的处理失败。

远程文件解析

下载网络资源时，快速识别文件真实类型，避免因文件扩展名与实际内容不符导致的处理问题。

技术优势

file-type 采用魔数检测技术，通过分析文件开头的特定字节序列来识别文件类型。这种方法具有检测速度快、准确率高、不依赖文件扩展名等优点。

性能表现

file-type 在检测过程中仅读取文件的前几个字节，不会加载整个文件内容，因此在处理大文件时也能保持高效性能。

总结

file-type 是一个功能强大且易于使用的文件类型检测工具，无论您是前端开发者还是后端工程师，都能从中受益。它的多环境支持和多种输入方式使得它在各种应用场景中都能大显身手。如果您正在寻找一个高效、准确的文件类型检测工具，file-type 绝对值得一试！

立即体验 file-type，让文件格式识别变得简单高效！