node-red-contrib-web-worldmap 2.24.0 → 2.25.0

package/CHANGELOG.md

@@ -1,12 +1,16 @@
 ### Change Log for Node-RED Worldmap
 
+ - v2.25.0 - Add bounds command to set overall map bounds.
+ - v2.24.3 - Fix geojson incorrect fill.
+ - v2.24.2 - Changes to drawing colours to be more visible.
+ - v2.24.1 - Fix ellipse accuracy.
  - v2.24.0 - Add greatcircle option, fix non default httpRoot. Issue #193
  - v2.23.5 - Fix addtoheatmap. Issue #192
  - v2.23.4 - Fix opacity of area borders
  - v2.23.3 - Fix initial load of maps
  - v2.23.2 - Add convex-hull example
  - v2.23.1 - Fix saving of custom map layer
- - v2.23.0 - Give logo and id so it can be overridden by toplogo command. PR #188.
+ - v2.23.0 - Give logo an id so it can be overridden by toplogo command. PR #188.
 
  - v2.22.3 - Don't show empty popup for geojson object. Issue #186. Add wobble to null island.
  - v2.22.2 - Be more tolerant of speed string types

package/README.md

@@ -11,13 +11,17 @@ map web page for plotting "things" on.
 
 ### Updates
 
+- v2.25.0 - Add bounds command to set overall map bounds.
+- v2.24.3 - Fix geojson incorrect fill.
+- v2.24.2 - Changes to drawing colours to be more visible.
+- v2.24.1 - Fix ellipse accuracy
 - v2.24.0 - Add greatcircle option, fix non default httpRoot. Issue #193
 - v2.23.5 - Fix addtoheatmap. Issue #192
 - v2.23.4 - Fix opacity of area borders
 - v2.23.3 - Fix initial load of maps
 - v2.23.2 - Add convex-hull example
 - v2.23.1 - Fix saving of custom map layer
-- v2.23.0 - Give logo and id so it can be overridden by toplogo command. PR #188.
+- v2.23.0 - Give logo an id so it can be overridden by toplogo command. PR #188.
 - v2.22.3 - Don't show empty popup for geojson object. Issue #186. Add wobble to null island.
 - v2.22.2 - Be more tolerant of speed string types
 - v2.22.0 - Separate out layer events in worldmap in
@@ -134,7 +138,7 @@ If the payload also includes a property `fit:true` the map will zoom to fit the
 Finally if a **greatcircle** property is set containing an array of two coordinates then an arc
 following the great circle between the two co-ordinates is plotted.
 
-    msg.payload = {name:"GC1", greatcircle:[ [51.464,0], [25.76,-80.18] ] }
+    msg.payload = {name:"GC1", color:"#ff00ff", greatcircle:[ [51.464,0], [25.76,-80.18] ] }
 
 There are extra optional properties you can specify - see Options below.
 
@@ -385,6 +389,7 @@ Optional properties include
  - **lat** - move map to specified latitude.
  - **lon** - move map to specified longitude.
  - **zoom** - move map to specified zoom level (1 - world, 13 to 20 max zoom depending on map).
+ - **bounds** - if set to an array `[ [ lat(S), lon(W) ], [lat(N), lon(E)] ]` - sets the overall map bounds.
  - **layer** - set map to specified base layer name - `{"command":{"layer":"Esri"}}`
  - **search** - search markers on map for name containing `string`. If not found in existing markers, will then try geocoding looking using Nominatim. An empty string `""` clears the search results. - `{"command":{"search":"Winchester"}}`
  - **showlayer** - show the named overlay(s) - `{"command":{"showlayer":"foo"}}` or `{"command":{"showlayer":["foo","bar"]}}`

package/node_modules/{bytes → body-parser/node_modules/bytes}/package.json

@@ -3,7 +3,7 @@
   "_id": "bytes@3.1.1",
   "_inBundle": false,
   "_integrity": "sha512-dWe4nWO/ruEOY7HkUJ5gFt1DCFV9zPRoJr8pV0/ASQermOZjtq8jMjOprC0Kd10GLN+l7xaUPvxzJFWtxGu8Fg==",
-  "_location": "/bytes",
+  "_location": "/node-red-contrib-web-worldmap/body-parser/bytes",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,8 +16,7 @@
     "fetchSpec": "3.1.1"
   },
   "_requiredBy": [
-    "/body-parser",
-    "/raw-body"
+    "/node-red-contrib-web-worldmap/body-parser"
   ],
   "_resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.1.tgz",
   "_shasum": "3f018291cb4cbad9accb6e6970bca9c8889e879a",

package/node_modules/body-parser/package.json

@@ -3,7 +3,7 @@
   "_id": "body-parser@1.19.1",
   "_inBundle": false,
   "_integrity": "sha512-8ljfQi5eBk8EJfECMrgqNGWPEY5jWP+1IzkzkGdFFEwFQZZyaZ21UqdaHktgiMlH0xLHqIFtE/u2OYE5dOtViA==",
-  "_location": "/body-parser",
+  "_location": "/node-red-contrib-web-worldmap/body-parser",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "1.19.1"
   },
   "_requiredBy": [
-    "/express"
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.19.1.tgz",
   "_shasum": "1499abbaa9274af3ecc9f6f10396c995943e31d4",

package/node_modules/content-disposition/node_modules/safe-buffer/package.json

@@ -3,7 +3,7 @@
   "_id": "safe-buffer@5.2.1",
   "_inBundle": false,
   "_integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-  "_location": "/content-disposition/safe-buffer",
+  "_location": "/node-red-contrib-web-worldmap/content-disposition/safe-buffer",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "5.2.1"
   },
   "_requiredBy": [
-    "/content-disposition"
+    "/node-red-contrib-web-worldmap/content-disposition"
   ],
   "_resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
   "_shasum": "1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6",

package/node_modules/content-disposition/package.json

@@ -3,7 +3,7 @@
   "_id": "content-disposition@0.5.4",
   "_inBundle": false,
   "_integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
-  "_location": "/content-disposition",
+  "_location": "/node-red-contrib-web-worldmap/content-disposition",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "0.5.4"
   },
   "_requiredBy": [
-    "/express"
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
   "_shasum": "8b82b4efac82512a02bb0b1dcec9d2c5e8eb5bfe",

package/node_modules/cookie/package.json

@@ -3,7 +3,7 @@
   "_id": "cookie@0.4.1",
   "_inBundle": false,
   "_integrity": "sha512-ZwrFkGJxUR3EIoXtO+yVE69Eb7KlixbaeAWfBQB9vVsNn/o+Yw69gBWSSDK825hQNdN+wF8zELf3dFNl/kxkUA==",
-  "_location": "/cookie",
+  "_location": "/node-red-contrib-web-worldmap/cookie",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "0.4.1"
   },
   "_requiredBy": [
-    "/express"
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.1.tgz",
   "_shasum": "afd713fe26ebd21ba95ceb61f9a8116e50a537d1",

package/node_modules/express/node_modules/safe-buffer/package.json

@@ -3,7 +3,7 @@
   "_id": "safe-buffer@5.2.1",
   "_inBundle": false,
   "_integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-  "_location": "/express/safe-buffer",
+  "_location": "/node-red-contrib-web-worldmap/express/safe-buffer",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "5.2.1"
   },
   "_requiredBy": [
-    "/express"
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
   "_shasum": "1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6",

package/node_modules/express/package.json

@@ -1,27 +1,26 @@
 {
-  "_from": "express@4.17.2",
+  "_from": "express@^4.17.2",
   "_id": "express@4.17.2",
   "_inBundle": false,
   "_integrity": "sha512-oxlxJxcQlYwqPWKVJJtvQiwHgosH/LrLSPA+H4UxpyvSS6jC5aH+5MoHFM+KABgTOt0APue4w66Ha8jCUo9QGg==",
-  "_location": "/express",
+  "_location": "/node-red-contrib-web-worldmap/express",
   "_phantomChildren": {},
   "_requested": {
-    "type": "version",
+    "type": "range",
     "registry": true,
-    "raw": "express@4.17.2",
+    "raw": "express@^4.17.2",
     "name": "express",
     "escapedName": "express",
-    "rawSpec": "4.17.2",
+    "rawSpec": "^4.17.2",
     "saveSpec": null,
-    "fetchSpec": "4.17.2"
+    "fetchSpec": "^4.17.2"
   },
   "_requiredBy": [
-    "#USER",
-    "/"
+    "/node-red-contrib-web-worldmap"
   ],
   "_resolved": "https://registry.npmjs.org/express/-/express-4.17.2.tgz",
   "_shasum": "c18369f265297319beed4e5558753cc8c1364cb3",
-  "_spec": "express@4.17.2",
+  "_spec": "express@^4.17.2",
   "_where": "/Users/conway/Projects/worldmap",
   "author": {
     "name": "TJ Holowaychuk",

package/node_modules/faye-websocket/package.json

@@ -3,7 +3,7 @@
   "_id": "faye-websocket@0.11.4",
   "_inBundle": false,
   "_integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==",
-  "_location": "/faye-websocket",
+  "_location": "/node-red-contrib-web-worldmap/faye-websocket",
   "_phantomChildren": {},
   "_requested": {
     "type": "range",
@@ -16,7 +16,7 @@
     "fetchSpec": "^0.11.3"
   },
   "_requiredBy": [
-    "/sockjs"
+    "/node-red-contrib-web-worldmap/sockjs"
   ],
   "_resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz",
   "_shasum": "7f0d9275cfdd86a1c963dc8b65fcc451edcbb1da",

package/node_modules/forwarded/package.json

@@ -3,7 +3,7 @@
   "_id": "forwarded@0.2.0",
   "_inBundle": false,
   "_integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
-  "_location": "/forwarded",
+  "_location": "/node-red-contrib-web-worldmap/forwarded",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "0.2.0"
   },
   "_requiredBy": [
-    "/proxy-addr"
+    "/node-red-contrib-web-worldmap/proxy-addr"
   ],
   "_resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
   "_shasum": "2269936428aad4c15c7ebe9779a84bf0b2a81811",

package/node_modules/http-errors/package.json

@@ -3,7 +3,7 @@
   "_id": "http-errors@1.8.1",
   "_inBundle": false,
   "_integrity": "sha512-Kpk9Sm7NmI+RHhnj6OIWDI1d6fIoFAtFt9RLaTMRlg/8w49juAStsrBgp0Dp4OdxdVbRIeKhtCUvoi/RuAhO4g==",
-  "_location": "/http-errors",
+  "_location": "/node-red-contrib-web-worldmap/http-errors",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,9 +16,9 @@
     "fetchSpec": "1.8.1"
   },
   "_requiredBy": [
-    "/body-parser",
-    "/raw-body",
-    "/send"
+    "/node-red-contrib-web-worldmap/body-parser",
+    "/node-red-contrib-web-worldmap/raw-body",
+    "/node-red-contrib-web-worldmap/send"
   ],
   "_resolved": "https://registry.npmjs.org/http-errors/-/http-errors-1.8.1.tgz",
   "_shasum": "7c3f28577cbc8a207388455dbd62295ed07bd68c",

package/node_modules/inherits/package.json

@@ -3,7 +3,7 @@
   "_id": "inherits@2.0.4",
   "_inBundle": false,
   "_integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
-  "_location": "/inherits",
+  "_location": "/node-red-contrib-web-worldmap/inherits",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "2.0.4"
   },
   "_requiredBy": [
-    "/http-errors"
+    "/node-red-contrib-web-worldmap/http-errors"
   ],
   "_resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
   "_shasum": "0fa2c64f932917c3433a0ded55363aae37416b7c",

package/node_modules/ipaddr.js/package.json

@@ -3,7 +3,7 @@
   "_id": "ipaddr.js@1.9.1",
   "_inBundle": false,
   "_integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
-  "_location": "/ipaddr.js",
+  "_location": "/node-red-contrib-web-worldmap/ipaddr.js",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,7 +16,7 @@
     "fetchSpec": "1.9.1"
   },
   "_requiredBy": [
-    "/proxy-addr"
+    "/node-red-contrib-web-worldmap/proxy-addr"
   ],
   "_resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
   "_shasum": "bff38543eeb8984825079ff3a2a8e6cbd46781b3",

package/node_modules/proxy-addr/package.json

@@ -3,7 +3,7 @@
   "_id": "proxy-addr@2.0.7",
   "_inBundle": false,
   "_integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
-  "_location": "/proxy-addr",
+  "_location": "/node-red-contrib-web-worldmap/proxy-addr",
   "_phantomChildren": {},
   "_requested": {
     "type": "range",
@@ -16,7 +16,7 @@
     "fetchSpec": "~2.0.7"
   },
   "_requiredBy": [
-    "/express"
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
   "_shasum": "f19fe69ceab311eeb94b42e70e8c2070f9ba1025",

package/node_modules/qs/package.json

@@ -3,7 +3,7 @@
   "_id": "qs@6.9.6",
   "_inBundle": false,
   "_integrity": "sha512-TIRk4aqYLNoJUbd+g2lEdz5kLWIuTMRagAXxl78Q0RiVjAOugHmeKNGdd3cwo/ktpf9aL9epCfFqWDEKysUlLQ==",
-  "_location": "/qs",
+  "_location": "/node-red-contrib-web-worldmap/qs",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
@@ -16,8 +16,8 @@
     "fetchSpec": "6.9.6"
   },
   "_requiredBy": [
-    "/body-parser",
-    "/express"
+    "/node-red-contrib-web-worldmap/body-parser",
+    "/node-red-contrib-web-worldmap/express"
   ],
   "_resolved": "https://registry.npmjs.org/qs/-/qs-6.9.6.tgz",
   "_shasum": "26ed3c8243a431b2924aca84cc90471f35d5a0ee",

package/node_modules/raw-body/node_modules/bytes/History.md

@@ -0,0 +1,92 @@
+3.1.1 / 2021-11-15
+==================
+
+  * Fix "thousandsSeparator" incorrecting formatting fractional part
+
+3.1.0 / 2019-01-22
+==================
+
+  * Add petabyte (`pb`) support
+
+3.0.0 / 2017-08-31
+==================
+
+  * Change "kB" to "KB" in format output
+  * Remove support for Node.js 0.6
+  * Remove support for ComponentJS
+
+2.5.0 / 2017-03-24
+==================
+
+  * Add option "unit"
+
+2.4.0 / 2016-06-01
+==================
+
+  * Add option "unitSeparator"
+
+2.3.0 / 2016-02-15
+==================
+
+  * Drop partial bytes on all parsed units
+  * Fix non-finite numbers to `.format` to return `null`
+  * Fix parsing byte string that looks like hex
+  * perf: hoist regular expressions
+
+2.2.0 / 2015-11-13
+==================
+
+  * add option "decimalPlaces"
+  * add option "fixedDecimals"
+
+2.1.0 / 2015-05-21
+==================
+
+  * add `.format` export
+  * add `.parse` export
+
+2.0.2 / 2015-05-20
+==================
+
+  * remove map recreation
+  * remove unnecessary object construction
+
+2.0.1 / 2015-05-07
+==================
+
+  * fix browserify require
+  * remove node.extend dependency
+
+2.0.0 / 2015-04-12
+==================
+
+  * add option "case"
+  * add option "thousandsSeparator"
+  * return "null" on invalid parse input
+  * support proper round-trip: bytes(bytes(num)) === num
+  * units no longer case sensitive when parsing
+
+1.0.0 / 2014-05-05
+==================
+
+ * add negative support. fixes #6
+
+0.3.0 / 2014-03-19
+==================
+
+ * added terabyte support
+
+0.2.1 / 2013-04-01
+==================
+
+  * add .component
+
+0.2.0 / 2012-10-28
+==================
+
+  * bytes(200).should.eql('200b')
+
+0.1.0 / 2012-07-04
+==================
+
+  * add bytes to string conversion [yields]

package/node_modules/raw-body/node_modules/bytes/LICENSE

@@ -0,0 +1,23 @@
+(The MIT License)
+
+Copyright (c) 2012-2014 TJ Holowaychuk <tj@vision-media.ca>
+Copyright (c) 2015 Jed Watson <jed.watson@me.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/raw-body/node_modules/bytes/Readme.md

@@ -0,0 +1,152 @@
+# Bytes utility
+
+[![NPM Version][npm-image]][npm-url]
+[![NPM Downloads][downloads-image]][downloads-url]
+[![Build Status][ci-image]][ci-url]
+[![Test Coverage][coveralls-image]][coveralls-url]
+
+Utility to parse a string bytes (ex: `1TB`) to bytes (`1099511627776`) and vice-versa.
+
+## Installation
+
+This is a [Node.js](https://nodejs.org/en/) module available through the
+[npm registry](https://www.npmjs.com/). Installation is done using the
+[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
+
+```bash
+$ npm install bytes
+```
+
+## Usage
+
+```js
+var bytes = require('bytes');
+```
+
+#### bytes(number｜string value, [options]): number｜string｜null
+
+Default export function. Delegates to either `bytes.format` or `bytes.parse` based on the type of `value`.
+
+**Arguments**
+
+| Name    | Type     | Description        |
+|---------|----------|--------------------|
+| value   | `number`｜`string` | Number value to format or string value to parse |
+| options | `Object` | Conversion options for `format` |
+
+**Returns**
+
+| Name    | Type             | Description                                     |
+|---------|------------------|-------------------------------------------------|
+| results | `string`｜`number`｜`null` | Return null upon error. Numeric value in bytes, or string value otherwise. |
+
+**Example**
+
+```js
+bytes(1024);
+// output: '1KB'
+
+bytes('1KB');
+// output: 1024
+```
+
+#### bytes.format(number value, [options]): string｜null
+
+Format the given value in bytes into a string. If the value is negative, it is kept as such. If it is a float, it is
+ rounded.
+
+**Arguments**
+
+| Name    | Type     | Description        |
+|---------|----------|--------------------|
+| value   | `number` | Value in bytes     |
+| options | `Object` | Conversion options |
+
+**Options**
+
+| Property          | Type   | Description                                                                             |
+|-------------------|--------|-----------------------------------------------------------------------------------------|
+| decimalPlaces | `number`｜`null` | Maximum number of decimal places to include in output. Default value to `2`. |
+| fixedDecimals | `boolean`｜`null` | Whether to always display the maximum number of decimal places. Default value to `false` |
+| thousandsSeparator | `string`｜`null` | Example of values: `' '`, `','` and `'.'`... Default value to `''`. |
+| unit | `string`｜`null` | The unit in which the result will be returned (B/KB/MB/GB/TB). Default value to `''` (which means auto detect). |
+| unitSeparator | `string`｜`null` | Separator to use between number and unit. Default value to `''`. |
+
+**Returns**
+
+| Name    | Type             | Description                                     |
+|---------|------------------|-------------------------------------------------|
+| results | `string`｜`null` | Return null upon error. String value otherwise. |
+
+**Example**
+
+```js
+bytes.format(1024);
+// output: '1KB'
+
+bytes.format(1000);
+// output: '1000B'
+
+bytes.format(1000, {thousandsSeparator: ' '});
+// output: '1 000B'
+
+bytes.format(1024 * 1.7, {decimalPlaces: 0});
+// output: '2KB'
+
+bytes.format(1024, {unitSeparator: ' '});
+// output: '1 KB'
+```
+
+#### bytes.parse(string｜number value): number｜null
+
+Parse the string value into an integer in bytes. If no unit is given, or `value`
+is a number, it is assumed the value is in bytes.
+
+Supported units and abbreviations are as follows and are case-insensitive:
+
+  * `b` for bytes
+  * `kb` for kilobytes
+  * `mb` for megabytes
+  * `gb` for gigabytes
+  * `tb` for terabytes
+  * `pb` for petabytes
+
+The units are in powers of two, not ten. This means 1kb = 1024b according to this parser.
+
+**Arguments**
+
+| Name          | Type   | Description        |
+|---------------|--------|--------------------|
+| value   | `string`｜`number` | String to parse, or number in bytes.   |
+
+**Returns**
+
+| Name    | Type        | Description             |
+|---------|-------------|-------------------------|
+| results | `number`｜`null` | Return null upon error. Value in bytes otherwise. |
+
+**Example**
+
+```js
+bytes.parse('1KB');
+// output: 1024
+
+bytes.parse('1024');
+// output: 1024
+
+bytes.parse(1024);
+// output: 1024
+```
+
+## License
+
+[MIT](LICENSE)
+
+[ci-image]: https://badgen.net/github/checks/visionmedia/bytes.js/master?label=ci
+[ci-url]: https://github.com/visionmedia/bytes.js/actions?query=workflow%3Aci
+[coveralls-image]: https://badgen.net/coveralls/c/github/visionmedia/bytes.js/master
+[coveralls-url]: https://coveralls.io/r/visionmedia/bytes.js?branch=master
+[downloads-image]: https://badgen.net/npm/dm/bytes
+[downloads-url]: https://npmjs.org/package/bytes
+[npm-image]: https://badgen.net/npm/v/bytes
+[npm-url]: https://npmjs.org/package/bytes