Image Info Extractor

A JavaScript lib to read image info and to extract/parse image metadata.

Warning This project is currently experimental.

Features

This lib supports most web image formats: JPEG, PNG, WebP, AVIF, SVG.

Image info reading

Image info reading support: width, height, alpha, bit depth, animation, lossless, rotation, mirror, progressive, grided

Note: the width and height are directly retrieved, you should also look at the rotation and mirror to render an image properly.

Metadata extracting

Metadata extracting support: EXIF, XMP, ICC

Additional extracting support: JFIF, Extended XMP, IPTC for JPEG, XMP in SVG

Table 1: raster image metadata extracting support (Y: yes, N: no)

Image format \ Metadata format	EXIF	XMP	ICC
JPEG	Y	Y	Y
PNG	Y	Y	Y
WebP	Y	Y	Y
AVIF	Y	Y	Y

Metadata parsing

Metadata parsing support: EXIF 2.32, XMP 1.0, ICC 4.4

Optional support:

Vendor-specific XMP tag type mapping

TODOs:

Vendor-specific EXIF MakerNote parsing

Data getters

Thumbnail data in EXIF
GPS info in EXIF
Date tags in EXIF

demo of Image Info Extractor

Install

Browser Requirements

Chromium 80
Firefox 113
Safari 16.4
Node.js 20

Install with NPM

npm install image-info-extractor

Usage

import {readFile, parseResult} from 'image-info-extractor';

// first, pick a file

// then pass the file to extractor
readFile(file).then(parseResult).then((result) => {
  console.log('result', result);
});

For detailed usage in browser, see image-info-extractor.html and sidecar-file-viewer.html under examples/

For detailed usage in Node.js, see image-info-extractor.js and sidecar-file-viewer.js under examples-nodejs/

Related Efforts

This project is derived, with heavy modifications, from

License

MIT

fuweichin / image-info-extractor

readme