The exifr npm package is a powerful tool for extracting EXIF (Exchangeable Image File Format) data from images. It supports a wide range of image formats and can extract various types of metadata, including GPS information, camera settings, and more.
Extract Basic EXIF Data
This feature allows you to extract basic EXIF data from an image. The code sample demonstrates how to use the `exifr.parse` method to read EXIF data from a specified image file.
const exifr = require('exifr');
async function getBasicExifData(imagePath) {
const exifData = await exifr.parse(imagePath);
console.log(exifData);
}
getBasicExifData('path/to/image.jpg');Extract GPS Data
This feature allows you to extract GPS data from an image. The code sample demonstrates how to use the `exifr.gps` method to read GPS metadata from a specified image file.
const exifr = require('exifr');
async function getGpsData(imagePath) {
const gpsData = await exifr.gps(imagePath);
console.log(gpsData);
}
getGpsData('path/to/image.jpg');Extract Thumbnail
This feature allows you to extract the thumbnail image embedded in the EXIF data. The code sample demonstrates how to use the `exifr.thumbnail` method to read the thumbnail from a specified image file.
const exifr = require('exifr');
async function getThumbnail(imagePath) {
const thumbnail = await exifr.thumbnail(imagePath);
console.log(thumbnail);
}
getThumbnail('path/to/image.jpg');The exif-parser package is another tool for extracting EXIF data from images. It is known for its performance and simplicity. Compared to exifr, exif-parser is more lightweight but may not support as many features or image formats.
The piexifjs package allows for both reading and writing EXIF data in JPEG images. It is a versatile tool for manipulating EXIF metadata. Compared to exifr, piexifjs offers more functionality for modifying EXIF data but may be more complex to use.
The jpeg-js package is a pure JavaScript implementation for decoding and encoding JPEG images. While it is not specifically focused on EXIF data, it can be used in conjunction with other tools to handle image metadata. Compared to exifr, jpeg-js is more general-purpose and not specialized in EXIF extraction.
Usage • Installation • Quick start • API • Performance • FAQ • Contributing
📷 The fastest and most versatile JavaScript EXIF reading library.
Try it yourself - demo page & playground.
Works everywhere, parses everything and handles anything you throw at it.
GPSLatitude, GPSLatitudeRef tags ([50, 17, 58.57] & "N") to single latitude value (50.29960).You don't need to read the whole file to tell if there's EXIF in it. And you don't need to extract all the data when you're looking for just a few tags. Exifr just jumps through the file structure, from pointer to pointer. Instead of reading it byte by byte, from beginning to end.
Exifr does what no other JS lib does. It's efficient and blazing fast!
file can be any binary format (Buffer, Uint8Array, Blob and more), <img> element, string path or url.
options specify what segments and blocks to parse, filters what tags to pick or skip.
| API | Returns | Description |
|---|---|---|
exifr.parse(file) | object | Parses IFD0, EXIF, GPS blocks |
exifr.parse(file, true) | object | Parses everything |
exifr.parse(file, ['Model', 'FNumber', ...]) | object | Parses only specified tags |
exifr.parse(file, {options}) | object | Custom settings |
exifr.gps(file) | {latitude, longitude} | Parses only GPS coords |
exifr.orientation(file) | number | Parses only orientation |
exifr.thumbnail(file) | `Buffer | Uint8Array` binary |
exifr.thumbnailUrl(file) | string Object URL | Browser only |
npm install exifr
Exifr comes in four prebuilt bundles. It's a good idea to start development with full and then scale down to lite, mini, or better yet, build your own around core build.
New Node: This library is written as an ES module, with import syntax and "type":"module" in package.json.
Old Node: If you still use CommonJS (require() syntax), you need load UMD bundle.
// modern node.js
import * as exifr from 'exifr' // => exifr/dist/full.esm.js
// older Node.js or CJS project
var exifr = require('exifr/dist/full.umd.js')
lite and mini are recommended for browsers because of balance between features and file size.
UMD format supports AMD (RequireJS) or attached everything to the global window.exifr object.
IE & old browsers: legacy build comes bundled with polyfills. Learn more.
<!-- modern browsers -->
<script type="module">import * as exifr from 'node_modules/exifr/dist/mini.esm.js'</script>
<!-- classic -->
<script src="https://cdn.jsdelivr.net/npm/exifr/dist/lite.umd.js"></script>
<!-- IE10 & old browsers. You also need Promise polyfill -->
<script src="https://cdn.jsdelivr.net/npm/exifr/dist/lite.legacy.umd.js"></script>
Of course, you can use the full version in browser, or use any other build in Node.js.
import syntax.require('exifr'), AMD/RequireJS and global window.exifr.Promise polyfill. Learn more here.| full | lite | mini | core | |
|---|---|---|---|---|
| chunked file readers | BlobReader UrlFetcher FsReader Base64Reader | BlobReader UrlFetcher | BlobReader | none |
| file parsers | *.jpg*.heic*.tif | *.jpg*.heic | *.jpg | none |
| segment parsers | TIFF (EXIF) IPTC XMP ICC JFIF | TIFF (EXIF) XMP | TIFF (EXIF) | none |
| dictionaries | TIFF (+ less frequent tags) IPTC ICC | only TIFF keys (IFD0, EXIF, GPS) | none | none |
| size +- | 60 Kb | 40 Kb | 25 Kb | 15 Kb |
| gzipped | 22 Kb | 12 Kb | 8 Kb | 4 Kb |
| file | full.esm.jsfull.umd.jsfull.legacy.umd.js | lite.esm.jslite.umd.jslite.legacy.umd.js | mini.esm.jsmini.umd.jsmini.legacy.umd.js | core.esm.jscore.umd.js |
// exifr reads the file from disk, only a few hundred bytes.
exifr.parse('./myimage.jpg')
.then(output => console.log('Camera:', output.Make, output.Model))
// Or read the file on your own and feed the buffer into exifr.
fs.readFile('./myimage.jpg')
.then(exifr.parse)
.then(output => console.log('Camera:', output.Make, output.Model))
Extract only GPS
let {latitude, longitude} = await exifr.gps('./myimage.jpg')
Extract only certain tags
let output = await exifr.parse(file, ['ISO', 'Orientation', 'LensModel'])
Extracting thumbnail
let thumbBuffer = await exifr.thumbnail(file)
// or get object URL (browser only)
img.src = await exifr.thumbnailUrl(file)
Web Worker
let worker = new Worker('./worker.js')
worker.postMessage('../test/IMG_20180725_163423.jpg')
worker.onmessage = e => console.log(e.data)
// tip: try Transferable Objects with ArrayBuffer
worker.postMessage(arrayBuffer, [arrayBuffer])
// worker.js
importScripts('./node_modules/exifr/dist/lite.umd.js')
self.onmessage = async e => postMessage(await exifr.parse(e.data))
UMD in Browser
<img src="./myimage.jpg">
<script src="./node_modules/exifr/dist/lite.umd.js"></script>
<script>
let img = document.querySelector('img')
window.exifr.parse(img).then(exif => console.log('Exposure:', exif.ExposureTime))
</script>
ESM in Browser
<input id="filepicker" type="file" multiple>
<script type="module">
import {parse} from './node_modules/exifr/dist/lite.esm.js'
document.querySelector('#filepicker').addEventListener('change', async e => {
let files = Array.from(e.target.files)
let exifs = await Promise.all(files.map(parse))
let dates = exifs.map(exif => exif.DateTimeOriginal.toGMTString())
console.log(`${files.length} photos taken on:`, dates)
})
</script>
and a lot more in the examples/ folder
exifr exports parse(), gps(), orientation(), thumbnail(), thumbnailUrl() functions and Exifr class
parse(file[, options])Returns: Promise<object>
Accepts file (in any format), parses it and returns exif object. Optional options argument can be specified.
gps(file)Returns: Promise<object>
Only extracts GPS coordinates.
Uses pick/skip filters and perf improvements to only extract latitude and longitude tags from GPS block. And to get GPS-IFD pointer it only scans through IFD0 without reading any other unrelated data.
Check out examples/gps.js to learn more.
orientation(file)Returns: Promise<number>
Only extracts photo's orientation.
thumbnail(file)Returns: Promise<Buffer|Uint8Array>
Extracts embedded thumbnail from the photo, returns Uint8Array.
Only parses as little EXIF as necessary to find offset of the thumbnail.
Check out examples/thumbnail.html and examples/thumbnail.js to learn more.
thumbnailUrl(file)Returns: Promise<string>
browser only
Exports the thumbnail wrapped in Object URL. The URL has to be revoked when not needed anymore.
Exifr classAforementioned functions are wrappers that internally:
new Exifr(options) class.read(file) to read the file.parse() or .extractThumbnail()You can instantiate Exif yourself to parse metadata and extract thumbnail efficiently at the same time. In Node.js it's also necessary to close the file with .file.close() if it's read in chunked mode.
let exr = new Exifr(options)
let output = await exr.read(file)
let buffer = await exr.extractThumbnail()
if (exr.file.chunked) await exr.file.close()
file argumentstring
BufferArrayBufferUint8ArrayDataViewBlob, File<img> elementoptions argumentarray of tags to parse, shortcut for options.picktrue shortcut to parse all segments and blocksobject with granular settingsAll other and undefined properties are inherited from defaults:
let defaultOptions = {
// APP Segments
jfif: false,
tiff: true,
xmp: false,
icc: false,
iptc: false,
// TIFF Blocks
ifd0: true, // aka image
ifd1: false, // aka thumbnail
exif: true,
gps: true,
interop: false,
// Other TIFF tags
makerNote: false,
userComment: false,
// Filters
skip: [],
pick: [],
// Formatters
translateKeys: true,
translateValues: true,
reviveValues: true,
sanitize: true,
mergeOutput: true,
silentErrors: true,
// Chunked reader
chunked: true,
firstChunkSize: undefined,
firstChunkSizeNode: 512,
firstChunkSizeBrowser: 65536, // 64kb
chunkSize: 65536, // 64kb
chunkLimit: 5
}
Exifr can avoid reading certain tags, instead of reading but not including them in the output, like other exif libs do. For example MakerNote tag from EXIF block is isually very large - tens of KBs. Reading such tag is a waste of time if you don't need it.
Tip: Using numeric tag codes is even faster than string names because exifr doesn't have to look up the strings in dictionaries.
options.pickType: Array<string|number>
Array of the only tags that will be parsed.
Specified tags are looked up in a dictionary. Their respective blocks are enabled for parsing, all other blocks are disabled. Parsing ends as soon as all requested tags are extracted.
// Only extracts three tags from EXIF block. IFD0, GPS and other blocks disabled.
{pick: ['ExposureTime', 'FNumber', 'ISO']}
// Only extracts three tags from EXIF block and one tag from GPS block.
{pick: ['ExposureTime', 'FNumber', 'ISO', 'GPSLatitude']}
// Extracts two tags from GPS block and all of IFD0 and EXIF blocks which are enabled by default.
{gps: {pick: ['GPSLatitude', 0x0004]}}
options.skipType: Array<string|number>
Default: ['MakerNote', 'UserComments']
Array of the tags that will not be parsed.
By default, MakerNote and UserComment tags are skipped. But that is configured elsewhere.
// Skips reading these three tags in any block
{skip: ['ImageWidth', 'Model', 'FNumber', 'GPSLatitude']}
// Skips reading three tags in EXIF block
{exif: {skip: ['ImageUniqueID', 42033, 'SubSecTimeDigitized']}}
EXIF became synonymous for all image metadata, but it's actually just one of many blocks inside TIFF segment. And there are more segment than just TIFF.
Jpeg stores various formats of data in APP-Segments. Heic and Tiff file formats use different structures or naming conventions but the idea is the same, so we refer to TIFF, XMP, IPTC, ICC and JFIF as Segments.
options.tiff type bool|object|Array default: true
options.jfif type bool default: false
options.xmp type bool default: false
options.iptc type bool default: false
options.icc type bool default: false
TIFF Segment consists of various IFD's (Image File Directories) aka blocks.
options.ifd0 (alias options.image) type bool|object|Array default: true
options.ifd1 (alias options.thumbnail) type bool|object|Array default: false
options.exif type bool|object|Array default: true
options.gps type bool|object|Array default: true
options.interop type bool|object|Array default: false
Notable large tags from EXIF block that are not parsed by default but can be enabed if needed.
options.makerNote type: bool default: false
options.userComment type: bool default: false
Extracted XMP tags are grouped by namespace. Each ns is separate object in output. E.g. output.xmlns, output.GPano, output.crs, etc...
For XMP Extended see options.multiSegment
Exifr contains minimalistic opinionated XML parser for parsing data from XMP. It may not be 100% spec-compliant, because XMP is based on XML which cannot be translated 1:1 to JSON. The output is opinionated and may alter or simplify the data structure. If the XMP parser doesn't suit you, it can be disabled by setting options.xmp.parse to false. Then a raw XMP string will be available at output.xmp.
options.mergeOutput:false: Tags of tiff namespace (<tiff:Model>) are merged into output.ifd0. Likewise exif ns is merged into output.exif.<rdf:Description foo:name="Exifr">
<foo:author>Mike Kovařík</foo:author>
<foo:description xml:lang="en-us">Some string here</foo:description>
<foo:formats><rdf:Seq><rdf:li>jpeg</rdf:li></rdf:Seq></foo:formats>
<foo:segments><rdf:Seq><rdf:li>xmp</rdf:li><rdf:li>tiff</rdf:li><rdf:li>iptc</rdf:li></rdf:Seq></foo:segments>
</rdf:Description>
parses as:
{
name: 'Exifr', // attribute belonging to the same namespace
author: 'Mike Kovařík', // simple tag of the namespace
description: {lang: 'en-us', value: 'Some string here'}, // tag with attrs and value becomes object
formats: 'jpeg', // single item array is unwrapped
segments: ['xmp', 'tiff', 'iptc'] // array as usual
}
options.multiSegmentType: bool
Default: false
Enables looking for more than just a single segment of ICC or XMP (XMP Extended).
In some rare cases the photo can contain additional layers, embedded images, or metadata that doesn't fit inside single 64kB (JPEG) segment.
Side effect: Disables chunked reading. The whole file has to be read to locate all segments.
When is it useful:
Sub-options:
options.xmp.multiSegmentoptions.icc.multiSegmentoptions.tiff serves as a shortcut for configuring all TIFF blocks:
options.tiff = true enables all TIFF blocks (sets them to true).options.tiff = false disables all TIFF blocks (sets them to false) except for those explicitly set to true in options.options.tiff = {...} applies the same sub-options to all TIFF blocks that are enabled.options.tiff = false can be paired with any other block(s) to disable all other blocks except for said block.
{interop: true, tiff: false}
// is a shortcut for
{interop: true, ifd0: false, exif: false, gps: false, ifd1: true}
Each TIFF block and the whole tiff segment can also be configured with object or array, much like the options argument.
object - enabled with custom options - filters (pick, skip) and formatters (translateKeys, translateValues, reviveValues)array - enabled, but only picks tags from this arrayTIFF blocks automatically inherit from options.tiff and then from options.
// Only extract FNumber + ISO tags from EXIF and GPSLatitude + GPSLongitude from GPS
{
exif: true, gps: true,
pick: ['FNumber', 'ISO', 'GPSLatitude', 0x0004] // 0x0004 is GPSLongitude
}
// is a shortcut for
{exif: ['FNumber', 'ISO'], gps: ['GPSLatitude', 0x0004]}
// which is another shortcut for
{exif: {pick: ['FNumber', 'ISO']}, gps: {pick: ['GPSLatitude', 0x0004]}}
options.chunkedType: bool
Default: true
Exifr can read only a few chunks instead of the whole file. It's much faster, saves memory and unnecessary disk reads or network fetches. Works great with complicated file structures - .tif files may point to metadata scattered throughout the file.
How it works: A first small chunk (of firstChunkSize) is read to determine if the file contains any metadata at all. If so, reading subsequent chunks (of chunkSize) continues until all requested segments are found or until chunkLimit is reached.
Supported inputs: Chunked is only effective with Blob, <img> element, string url, disk path, or base64. These inputs are not yet processed or read into memory. Each input format is implemented in a separate file reader class. Learn more about file readers and modularity here.
If you use URL as input: Fetching chunks (implemented in UrlFetcher) from web server uses HTTP Range Requests. Range request may fail if your server does not support ranges, if it's not configured properly or if the fetched file is smaller than the first chunk size. Test your web server or disable chunked reader with {chunked: false} when in doubt.
options.firstChunkSizeType: number
Default: 512 Bytes in Node / 65536 (64 KB) in browser
Size (in bytes) of the first chunk that probes the file for traces of exif or metadata.
In browser, it's usually better to read just a larger chunk in hope that it contains the whole EXIF (and not just the beginning) instead of loading multiple subsequent chunks. Whereas in Node.js it's preferable to read as little data as possible and fs.read() does not cause slowdowns.
options.chunkSizeType: number
Default: 65536 Bytes (64 KB)
Size of subsequent chunks that may be read after the first chunk.
options.chunkLimitType: number
Default: 5
Max amount of subsequent chunks allowed to read in which exifr searches for data segments and blocks. I.e. failsafe that prevents from reading the whole file if it does not contain all of the segments or blocks requested in options.
This limit is bypassed if multi-segment segments ocurs in the file and if options.multiSegment allows reading all of them.
If the exif isn't found within N chunks (64*5 = 320KB) it probably isn't in the file and it's not worth reading anymore.
options.mergeOutputType: bool
Default: true
Merges all parsed segments and blocks into a single object.
Warning: mergeOutput: false should not be used with translateKeys: false or when parsing both ifd0 (image) and ifd1 (thumbnail). Tag keys are numeric, sometimes identical and may collide.
| mergeOutput: false | mergeOutput: true |
{
Make: 'Google',
Model: 'Pixel',
FNumber: 2,
Country: 'Czech Republic',
xmp: '<x:xmpmeta><rdf:Description>...'
}
| {
ifd0: {
Make: 'Google',
Model: 'Pixel'
},
exif: {
FNumber: 2
},
iptc: {
Country: 'Czech Republic'
},
xmp: '<x:xmpmeta><rdf:Description>...'
}
|
options.sanitizeType: bool
Default: true
Cleans up unnecessary, untransformed or internal tags (IFD pointers) from the output.
options.silentErrorsType: bool
Default: true
Error messages are stored at output.errors instead of thrown as Error instances and causing promise rejection.
Failing silently enables reading broken files. But only file-structure related errors are caught.
options.translateKeysType: bool
Default: true
Translates tag keys from numeric codes to understandable string names. I.e. uses Model instead of 0x0110.
Most keys are numeric. To access the Model tag use output.ifd0[0x0110] or output.ifd0[272]
Learn more about dictionaries.
Warning: translateKeys: false should not be used with mergeOutput: false. Keys may collide because ICC, IPTC and TIFF segments use numeric keys starting at 0.
| translateKeys: false | translateKeys: true |
{
0x0110: 'Pixel', // IFD0
90: 'Vsetín', // IPTC
64: 'Perceptual', // ICC
desc: 'sRGB IEC61966-2.1', // ICC
} | {
Model: 'Pixel', // IFD0
City: 'Vsetín', // IPTC
RenderingIntent: 'Perceptual', // ICC
ProfileDescription: 'sRGB IEC61966-2.1', // ICC
} |
options.translateValuesType: bool
Default: true
Translates tag values from raw enums to understandable strings. Learn more about dictionaries.
| translateValues: false | translateValues: true |
{
Orientation: 1,
ResolutionUnit: 2,
DeviceManufacturer: 'GOOG'
}
| {
Orientation: 'Horizontal (normal)',
ResolutionUnit: 'inches',
DeviceManufacturer: 'Google'
}
|
options.reviveValuesType: bool
Default: true
Converts dates from strings to a Date instances and modifies few other tags to a more readable format. Learn more about dictionaries.
| reviveValues: false | reviveValues: true |
{
GPSVersionID: [0x02, 0x02, 0x00, 0x00],
ModifyDate: '2018:07:25 16:34:23',
}
| {
GPSVersionID: '2.2.0.0',
ModifyDate: <Date instance: 2018-07-25T14:34:23.000Z>,
}
|
Tips for advanced users. You don't need to read further unless you're into customization and bundlers.
This is mostly relevant for Web Browsers, where file size and unused code elimination is important.
The library's functionality is divided into four categories.
BlobReader (browser), UrlFetcher (browser), FsReader (Node.js), Base64Reader
src/file-parsers/..jpg, .tiff, .heic
src/file-parsers/.src/segment-parsers/.src/dicts/.Each reader, parser and dictionary is broken into a separate file that can be loaded and used independently. This way you can build your own bundle with only what you need, eliminate dead code and save tens of KBs of unused dictionaries.
Any file format can be read out of the box. But custom reader class for each format is needed to enable chunked reading.
EXIF Data are mostly numeric enums, stored under numeric code. Dictionaries are needed to translate them into meaningful output. But they take up a lot of space (40 KB out of full build's 60 KB). So it's a good idea to make your own bundle and shave off the dicts you don't need.
output.Model instead of output[0x0110])Orientation becomes 'Rotate 180' instead of 3)Date)Exifr's dictionaries are based on exiftool.org. Specifically these: TIFF (EXIF & GPS), ICC, IPTC, JFIF
Scenario 1: We're using lite build and it's ok, but some tags are left untranslated. To fix that we need to import extension of TIFF dictionary with less frequent tags.
// Lite bundle only contains basic set of TIFF tags
import * as exifr from 'exifr/dist/lite.esm.js'
// Load TIFF dict extension with names of less frequent tags.
import 'exifr/src/dicts/tiff-other-keys.js'
Scenario 2: We'll be handling .jpg files in blob format and we want to extract ICC data in human-readable format. For that we'll need dictionaries for ICC segment.
// Core bundle has nothing in it
import * as exifr from 'exifr/dist/core.esm.js'
// Now we import what we need
import 'exifr/src/file-readers/BlobReader.js'
import 'exifr/src/file-parsers/jpeg.js'
import 'exifr/src/segment-parsers/icc.js'
import 'exifr/src/dicts/icc-keys.js'
import 'exifr/src/dicts/icc-values.js'
Scenario 3: We want to parse .heic and .tiff photos, extract EXIF block (of TIFF segment). We only need the values to be translated. Keys will be left untranslated but we don't mind accessing them with raw numeric keys - output[0xa40a] instead of output.Sharpness. Also, we're not importing any (chunked) file reader because we only work with Uint8Array data.
import * as exifr from 'exifr/dist/core.esm.js'
import 'exifr/src/file-parsers/heic.js'
import 'exifr/src/file-parsers/tiff.js'
import 'exifr/src/segment-parsers/tiff.js'
import 'exifr/src/dicts/tiff-exif-values.js'
// Modify single tag's 0xa409 (Saturation) translation
import {tagKeys, tagValues} from 'exifr'
let exifKeys = tagKeys.get('exif')
let exifValues = tagValues.get('exif')
exifKeys.set(0xa409, 'Saturation')
exifValues.set(0xa409, {
0: 'Normal',
1: 'Low',
2: 'High'
})
// Modify single tag's GPSDateStamp value is processed
import {tagRevivers} from 'exifr'
let gpsRevivers = tagRevivers.get('gps')
gpsRevivers.set(0x001D, rawValue => {
let [year, month, day] = rawValue.split(':').map(str => parseInt(str))
return new Date(year, month - 1, day)
})
// Create custom dictionary for GPS block
import {tagKeys, createDictionary} from 'exifr'
createDictionary(tagKeys, 'gps', [
[0x0001, 'LatitudeRef'],
[0x0002, 'Latitude'],
[0x0003, 'LongitudeRef'],
[0x0004, 'Longitude'],
])
// Extend existing IFD0 dictionary
import {tagKeys, createDictionary} from 'exifr'
createDictionary(tagKeys, 'ifd0', [
[0xc7b5, 'DefaultUserCrop'],
[0xc7d5, 'NikonNEFInfo'],
...
])
fs module. The import is obviously only used in Node.js and not triggered in a browser. But your bundler may, however, pick up on it and fail with something like Error: Can't resolve 'fs'.
Parcel works out of the box and Webpack should too because of webpackIgnore magic comment added to the library's source code import(/* webpackIgnore: true */ 'fs').
If this does not work for you, try adding node: {fs: 'empty'} and target: 'web' or target: 'webworker' to your Webpack config. Or similar settings for your bundler of choice.
Alternatively, create your own bundle around core build and do not include FsReader in it.
Exifr is written using modern syntax, mainly async/await. You may need to add regenerator-runtime or reconfigure babel.
You can also inject XML parser into exifr and have it process the XMP string.
// Exifr offers you an API for using your own XML parser while parsing XMP.
// 1) get the XmlParser class.
let XmpParser = Exifr.segmentParsers.get('xmp')
// 2) Implement parseXml() method. It accepts string argument. What is returned ends up as output.xmp.
XmpParser.prototype.parseXml = function(xmpString) {
return 'Bring Your Own XML parser here: ' + xmpString
}
Here are a few tips for when you need to squeeze an extra bit of speed out of exifr when processing a large amount of files. Click to expand.
options.pick if you only need certain tags// do this:
let {ISO, FNumber} = await exifr.parse(file, {exif: ['ISO', 'FNumber']})
// not this:
let {ISO, FNumber} = await exifr.parse(file)
options.ifd0 if you don't need the data// do this:
let options = {ifd0: false, exif: true}
// not this:
let options = {exif: true}
exifr.gps() if you only need GPSexifr.gps() because it is fine-tuned to do exactly this and nothing more. Similarly there's exifr.orientation().
// do this:
exifr.gps(file)
// not this:
exifr.parse(file, {gps: true})
options objectoptions object instead of inlining it. Exifr uses your options to create an instance of Options class under the hood and uses WeakMap to find previously created instance instead of creating q new one each time.
// do this:
let options = {exif: true, iptc: true}
for (let file of files) exif.parse(file, options)
// not this:
for (let file of files) exif.parse(file, {exif: true, iptc: true})
File reading: You don't need to read the whole file and parse through a MBs of data. Exifr takes an educated guess to only read a small chunk of the file where metadata is usually located. Each platform, file format, and data type is approached differently to ensure the best performance.
Finding metadata: Other libraries use brute force to read through all bytes until 'Exif' string is found. Whereas exifr recognizes the file structure, consisting of segments (JPEG) or nested boxes (HEIC). This allows exifr to read just a few bytes here and there, to get the offset and size of the segment/box and pointers to jump to the next.
HEIC: Simply finding the exif offset takes 0.2-0.3ms with exifr. Compare that to exif-heic-js which takes about 5-10ms on average. Exifr is up to 30x faster.
Try the benchmark yourself at benchmark/chunked-vs-whole.js
user reads file 8.4 ms
exifr reads whole file 8.2 ms
exifr reads file by chunks 0.5 ms <--- !!!
only parsing, not reading 0.2 ms <--- !!!
Observations from testing with +-4MB pictures (Highest quality Google Pixel photos. Tested on a mid-range dual-core i5 machine with SSD).
fs.readFile = 0.3msArrayBuffer = 3msBlob = 7ms<img> with Object URL = 3msBe sure to visit the exifr playground or benchmark/gps-dnd.html, drop in your photos and watch the parsed in timer.
See CHANGELOG.md
TL;DR: Because exifr comes in four bundles, each in three variants, plus source codes are included.
npm (~600 kB): The module includes both src/ and dist/. That source codes of all the readers, parsers and dictionaries. Multiplied by 4 bundles (full, lite, mini, core). Then multiplied by 3 bundle formats (ESM, UMD, legacy for IE11). But you will never use all of the files. They're there so you can choose what's best for your project.
bundlephobia (~63/22 kB): Full build is the "main" entry point (in package.json) picked up by Node and bundlephobia. But it's meant for use in Node where size doesn't matter.
badge in readme (~9 kB, ~30 files): The badge points to mini bundle which contains the bare minimum needed to cover the most use-cases (get orientation, coords, exif info, etc...). This is meant for browsers where file size matters.
Contributions are welcome in any form. Suggestions, bug reports, docs improvements, new tests or even feature PRs. Don't be shy, I don't bite.
If you're filing a bug, please include the problematic photo. Or better yet write a test.
If you're creating a PR, please run the tests:
/test/index.html (uses import maps, you may need to enable experimental flags in your browser)npm run testMIT, Mike Kovařík, Mutiny.cz
[4.1.0]
legacy bundle)TextDecoder, Object.assign, Object.keys, Object.values, Object.fromEntries, Array.from, Array.prototype.includes, fetch, Map, Set.Promise polyfill is needed now instead of regeneratorRuntimeFAQs
📷 The fastest and most versatile JavaScript EXIF reading library.
The npm package exifr receives a total of 118,617 weekly downloads. As such, exifr popularity was classified as popular.
We found that exifr demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.
Security News
vlt introduced its new package manager and a serverless registry this week, innovating in a space where npm has stagnated.