Know thy files
Mimetics determines the file type, MIME type, and media type of a given file using magic numbers and content analysis to detect the most likely file type and then maps that to the appropriate MIME and media type. I've included all of the file types that GPT could think of, but if I'm missing any please submit a pull request.
- Detects file type using magic numbers
- Detects file type using text content analysis
- Extracts the MIME and media types
- Supports wide variety of file types.
- Extendable with user-defined magic numbers, MIME types and file types
npm install mimetics
Basic Usage
Read a file and pass the resulting buffer to Mimetics, which analyzes it to determine its file type, MIME type, and media type:
const mimetics = require('mimetics')
const fs = require('fs')
const buffer = fs.readFileSync('example.jpg')
// call it as a function:
const fileInfo = mimetics(buffer)
// or, you can call the `parse` method:
const fileInfo = mimetics.parse(buffer)
console.log(fileInfo) // Logs { ext: 'jpg', mime: 'image/jpeg', media: 'image' }
In the Browser
const fileInput = document.getElementById('myFileInput')
fileInput.addEventListener('change', (event) => {
const file = event.target.files[0]
const reader = new FileReader()
reader.onload = (event) => {
const arrayBuffer = event.target.result
const fileInfo = mimetics(arrayBuffer)
console.log(fileInfo)
}
reader.readAsArrayBuffer(file)
})
Adding Custom Magic Numbers
Here, we're adding a custom magic number for a hypothetical file type and then using Mimetics to analyze a file of that type:
const mimetics = require('mimetics')
const fs = require('fs')
const buffer = fs.readFileSync('example.custom')
const mm = new mimetics({
magic: { custom: [0x43, 0x55, 0x53, 0x54] }
})
const fileInfo = mm.parse(buffer)
console.log(fileInfo) // Logs { ext: 'custom', mime: 'application/octet-stream', media: 'application' }
Adding Custom MIME Types
Here, we're adding a custom MIME type for a specific file extension:
const Mimetics = require('mimetics')
const fs = require('fs')
const buffer = fs.readFileSync('example.custom')
const mm = new Mimetics()
mm.addMimeType('custom', 'application/x-custom')
const fileInfo = mm.parse(buffer)
console.log(fileInfo) // Logs { ext: 'custom', mime: 'application/x-custom', media: 'application' }
Mimetics exports a single class with the following methods:
parse(buffer: Buffer): Object
- Takes in a Buffer and returns an object with the file type (ext
), MIME type (mime
), and media type (media
).getFileType(buffer: Buffer): string
- Determines the file type from the provided buffer.getMimeType(extension: string): string
- Returns the MIME type for the provided file extension.getMediaType(extension: string): string
- Returns the media type for the provided file extension.
Mimetics also provides a comprehensive API to customize and extend the default behavior:
setOptions(opts: Object): Mimetics
- Sets options for the instance, enabling the addition of custom magic numbers, MIME types, file types and edge cases.addMagicNumber(ext: string, magicNumber: Array<number>): void
- Adds a new magic number to the instance's magicNumbers map.addMimeType(ext: string, mimeType: string): void
- Adds a new MIME type to the instance's mimeTypeMap.addFileType(ext: string, regex: RegExp): void
- Adds a new file type to the instance's fileTypeMap.addEdgeCase(specialExt: string, extList: Array<string>): void
- Adds a new edge case to the instance's edgeCases map.
Takes a buffer as input, identifies the file type, mime type, and media type, and returns an object containing these three properties: ext
, mime
, media
.
buffer
- Buffer - The input buffer to be parsed.
An object containing the determined file type, mime type, and media type.
For more detailed API documentation, see the API reference and the comments in the code.
Contributions are welcome. Submit a Pull Request or open an Issue to discuss any changes. Please read contributing.md for details on our code of conduct, and the process for submitting merge requests to us.
Mimetics includes a test suite built with testr.
To run the test, first clone the respository:
git clone https://github.com/basedwon/mimetics.git
Install the dependencies, then run npm test
:
npm install
npm test
If you find this project useful and want to help support further development, please send us some coin. We greatly appreciate any and all contributions. Thank you!
Bitcoin (BTC):
1JUb1yNFH6wjGekRUW6Dfgyg4J4h6wKKdF
Monero (XMR):
46uV2fMZT3EWkBrGUgszJCcbqFqEvqrB4bZBJwsbx7yA8e2WBakXzJSUK8aqT4GoqERzbg4oKT2SiPeCgjzVH6VpSQ5y7KQ
Mimetics is MIT licensed.