is-mime

Is Mime

Checks whether a buffer or stream is a valid MIME type. Checks known byte offsets for magic numbers.

Examples

Checking streams:

var fs = require('fs')
  , assert = require('assert')
  , isMime = require('is-mime')
  , input, checker

input = fs.createReadStream(__dirname + '/image.jpg')

// checker is a PassThrough stream that emits `mimetype` event
checker = isMime.checkStream(['image/jpeg', 'image/png'])

checker.on('mimetype', function(mimetype) {
	// emitted once it is certain that stream contains
	// one of the provided types

	// argument is the detected mime type
	assert.equal(mimetype, 'image/jpeg')

	// also sets a `mimetype` property on stream object itself
	assert.equal(stream.mimetype, 'image/jpeg')
})

input.pipe(checker)
checker.resume() // discard data

Copy a file and print the detected MIME type:

var fs = require('fs')
  , isMime = require('is-mime')

fs.createReadStream(__dirname + '/image.png')
.pipe(
	isMime.checkStream([
		'image/jpeg',
		'image/png',
		'image/gif',
	])
	.on('mimetype', console.log)
)
.pipe(
	fs.createWriteStream(__dirname + '/image2.png')
	.on('end', function() {
		console.log('Copying finished')
	})
)

Checking buffers:

var fs = require('fs')
  , assert = require('assert')
  , isMime = require('is-mime')

fs.readFile(__dirname + '/image.png', function(err, buffer) {
	if (err) throw err

	// simply pass a type and buffer to `checkBuffer`
	// it will return the type string or null
	assert.ok(isMime.checkBuffer('image/png', buffer))
	// first argument can be an array too
})

Supported MIME types

• image/png
• image/jpeg
• image/gif
• image/webp
• audio/mpeg (MP3)
• audio/ogg (Vorbis, Opus)
• video/webm
• video/mp4