Parse physical object dimensions and convert them into a standardized form.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests
README.md
index.js
package.json

README.md

Node.js Parse Dimensions

Parse physical object dimensions and convert them into a standardized form.

Example

const pd = require("parse-dimensions");

console.log(pd.parseDimension("4in x 5in"));
// { original: '4in x 5in', unit: 'mm', width: 101.6, height: 127 }

console.log(pd.parseDimension("4.2cm x 5.1cm"));
// { original: '4.2cm x 5.1cm', unit: 'mm', width: 42, height: 51 }

You can see a full list of all the types of dimension strings handled in the test file.

Created by John Resig for parsing dimensions from museums, universities, galleries, and dealers for Ukiyo-e.org.

Installation

npm install parse-dimensions

API

parseDimension(dimensionString, [flip])

Parse a string that holds some dimensions and returns an object representing the dimensions. By default it assumes that the width is first. Pass a boolean as the second argument to assume the height is first.

parseDimensions(dimensionsString, [flip])

Parse a string that holds a set of dimensions and returns an array of objects representing the dimensions. It assumes that the dimensions are separated by semicolons by default.

convertNumber(number, fromUnit, toUnit)

Convert a number from one dimension unit to another. For example: convertNumber(10, "mm", "cm") will return 1.

convertDimension(dimensionObject, toUnit)

Given a dimension object (as produced by parseDimension) convert it to use a different dimension. Returns the modified dimension object.

License

Released under an MIT license.