Media Type Detector

A tiny utility to detect and classify the category of a file (image, video, audio, document, etc.) from a Blob using file-type.

Written in TypeScript
Works in the browser
Ready for use in React apps

Installation

1npm install media-type-detector
2
3yarn add media-type-detector

Usage

1import { detectMediaCategory, urlToBlob, getBlobAndDetectCategory } from 'media-type-detector';
2
3// Example 1: Detect category from a Blob or File directly
4const file = new Blob(['...'], { type: 'image/png' });
5const category1 = await detectMediaCategory(file);
6console.log('Category from Blob:', category1); // e.g. 'image'
7
8// Example 2: Convert a URL to a Blob
9const url = 'https://example.com/image.png';
10try {
11  const blob = await urlToBlob(url);
12  console.log('Blob fetched from URL:', blob);
13} catch (error) {
14  console.error('Failed to fetch blob:', error);
15}
16
17// Example 3: Fetch a file from a URL and detect its media category in one step
18const category3 = await getBlobAndDetectCategory(url);
19console.log('Category from URL:', category3); // e.g. 'image'
20

Options

1detectMediaCategory(blob, {
2  throwOnError?: boolean;
3  logger?: (error: Error) => void;
4});

Categories

The function returns one of the following media categories:

Category	Description
image	Image file types
video	Video file types
audio	Audio file types
pdf	PDF documents
word	Microsoft Word files
excel	Microsoft Excel files
csv	CSV files
text	Plain text files
other	Other or uncategorized
unknown	Unable to determine