홍지윤

Update .gitignore

Showing 494 changed files with 0 additions and 4894 deletions
1 -#!/bin/sh
2 -basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3 -
4 -case `uname` in
5 - *CYGWIN*|*MINGW*|*MSYS*) basedir=`cygpath -w "$basedir"`;;
6 -esac
7 -
8 -if [ -x "$basedir/node" ]; then
9 - "$basedir/node" "$basedir/../mime/cli.js" "$@"
10 - ret=$?
11 -else
12 - node "$basedir/../mime/cli.js" "$@"
13 - ret=$?
14 -fi
15 -exit $ret
1 -@ECHO off
2 -SETLOCAL
3 -CALL :find_dp0
4 -
5 -IF EXIST "%dp0%\node.exe" (
6 - SET "_prog=%dp0%\node.exe"
7 -) ELSE (
8 - SET "_prog=node"
9 - SET PATHEXT=%PATHEXT:;.JS;=;%
10 -)
11 -
12 -"%_prog%" "%dp0%\..\mime\cli.js" %*
13 -ENDLOCAL
14 -EXIT /b %errorlevel%
15 -:find_dp0
16 -SET dp0=%~dp0
17 -EXIT /b
1 -#!/usr/bin/env pwsh
2 -$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
3 -
4 -$exe=""
5 -if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
6 - # Fix case when both the Windows and Linux builds of Node
7 - # are installed in the same directory
8 - $exe=".exe"
9 -}
10 -$ret=0
11 -if (Test-Path "$basedir/node$exe") {
12 - & "$basedir/node$exe" "$basedir/../mime/cli.js" $args
13 - $ret=$LASTEXITCODE
14 -} else {
15 - & "node$exe" "$basedir/../mime/cli.js" $args
16 - $ret=$LASTEXITCODE
17 -}
18 -exit $ret
This diff is collapsed. Click to expand it.
1 -1.3.7 / 2019-04-29
2 -==================
3 -
4 - * deps: negotiator@0.6.2
5 - - Fix sorting charset, encoding, and language with extra parameters
6 -
7 -1.3.6 / 2019-04-28
8 -==================
9 -
10 - * deps: mime-types@~2.1.24
11 - - deps: mime-db@~1.40.0
12 -
13 -1.3.5 / 2018-02-28
14 -==================
15 -
16 - * deps: mime-types@~2.1.18
17 - - deps: mime-db@~1.33.0
18 -
19 -1.3.4 / 2017-08-22
20 -==================
21 -
22 - * deps: mime-types@~2.1.16
23 - - deps: mime-db@~1.29.0
24 -
25 -1.3.3 / 2016-05-02
26 -==================
27 -
28 - * deps: mime-types@~2.1.11
29 - - deps: mime-db@~1.23.0
30 - * deps: negotiator@0.6.1
31 - - perf: improve `Accept` parsing speed
32 - - perf: improve `Accept-Charset` parsing speed
33 - - perf: improve `Accept-Encoding` parsing speed
34 - - perf: improve `Accept-Language` parsing speed
35 -
36 -1.3.2 / 2016-03-08
37 -==================
38 -
39 - * deps: mime-types@~2.1.10
40 - - Fix extension of `application/dash+xml`
41 - - Update primary extension for `audio/mp4`
42 - - deps: mime-db@~1.22.0
43 -
44 -1.3.1 / 2016-01-19
45 -==================
46 -
47 - * deps: mime-types@~2.1.9
48 - - deps: mime-db@~1.21.0
49 -
50 -1.3.0 / 2015-09-29
51 -==================
52 -
53 - * deps: mime-types@~2.1.7
54 - - deps: mime-db@~1.19.0
55 - * deps: negotiator@0.6.0
56 - - Fix including type extensions in parameters in `Accept` parsing
57 - - Fix parsing `Accept` parameters with quoted equals
58 - - Fix parsing `Accept` parameters with quoted semicolons
59 - - Lazy-load modules from main entry point
60 - - perf: delay type concatenation until needed
61 - - perf: enable strict mode
62 - - perf: hoist regular expressions
63 - - perf: remove closures getting spec properties
64 - - perf: remove a closure from media type parsing
65 - - perf: remove property delete from media type parsing
66 -
67 -1.2.13 / 2015-09-06
68 -===================
69 -
70 - * deps: mime-types@~2.1.6
71 - - deps: mime-db@~1.18.0
72 -
73 -1.2.12 / 2015-07-30
74 -===================
75 -
76 - * deps: mime-types@~2.1.4
77 - - deps: mime-db@~1.16.0
78 -
79 -1.2.11 / 2015-07-16
80 -===================
81 -
82 - * deps: mime-types@~2.1.3
83 - - deps: mime-db@~1.15.0
84 -
85 -1.2.10 / 2015-07-01
86 -===================
87 -
88 - * deps: mime-types@~2.1.2
89 - - deps: mime-db@~1.14.0
90 -
91 -1.2.9 / 2015-06-08
92 -==================
93 -
94 - * deps: mime-types@~2.1.1
95 - - perf: fix deopt during mapping
96 -
97 -1.2.8 / 2015-06-07
98 -==================
99 -
100 - * deps: mime-types@~2.1.0
101 - - deps: mime-db@~1.13.0
102 - * perf: avoid argument reassignment & argument slice
103 - * perf: avoid negotiator recursive construction
104 - * perf: enable strict mode
105 - * perf: remove unnecessary bitwise operator
106 -
107 -1.2.7 / 2015-05-10
108 -==================
109 -
110 - * deps: negotiator@0.5.3
111 - - Fix media type parameter matching to be case-insensitive
112 -
113 -1.2.6 / 2015-05-07
114 -==================
115 -
116 - * deps: mime-types@~2.0.11
117 - - deps: mime-db@~1.9.1
118 - * deps: negotiator@0.5.2
119 - - Fix comparing media types with quoted values
120 - - Fix splitting media types with quoted commas
121 -
122 -1.2.5 / 2015-03-13
123 -==================
124 -
125 - * deps: mime-types@~2.0.10
126 - - deps: mime-db@~1.8.0
127 -
128 -1.2.4 / 2015-02-14
129 -==================
130 -
131 - * Support Node.js 0.6
132 - * deps: mime-types@~2.0.9
133 - - deps: mime-db@~1.7.0
134 - * deps: negotiator@0.5.1
135 - - Fix preference sorting to be stable for long acceptable lists
136 -
137 -1.2.3 / 2015-01-31
138 -==================
139 -
140 - * deps: mime-types@~2.0.8
141 - - deps: mime-db@~1.6.0
142 -
143 -1.2.2 / 2014-12-30
144 -==================
145 -
146 - * deps: mime-types@~2.0.7
147 - - deps: mime-db@~1.5.0
148 -
149 -1.2.1 / 2014-12-30
150 -==================
151 -
152 - * deps: mime-types@~2.0.5
153 - - deps: mime-db@~1.3.1
154 -
155 -1.2.0 / 2014-12-19
156 -==================
157 -
158 - * deps: negotiator@0.5.0
159 - - Fix list return order when large accepted list
160 - - Fix missing identity encoding when q=0 exists
161 - - Remove dynamic building of Negotiator class
162 -
163 -1.1.4 / 2014-12-10
164 -==================
165 -
166 - * deps: mime-types@~2.0.4
167 - - deps: mime-db@~1.3.0
168 -
169 -1.1.3 / 2014-11-09
170 -==================
171 -
172 - * deps: mime-types@~2.0.3
173 - - deps: mime-db@~1.2.0
174 -
175 -1.1.2 / 2014-10-14
176 -==================
177 -
178 - * deps: negotiator@0.4.9
179 - - Fix error when media type has invalid parameter
180 -
181 -1.1.1 / 2014-09-28
182 -==================
183 -
184 - * deps: mime-types@~2.0.2
185 - - deps: mime-db@~1.1.0
186 - * deps: negotiator@0.4.8
187 - - Fix all negotiations to be case-insensitive
188 - - Stable sort preferences of same quality according to client order
189 -
190 -1.1.0 / 2014-09-02
191 -==================
192 -
193 - * update `mime-types`
194 -
195 -1.0.7 / 2014-07-04
196 -==================
197 -
198 - * Fix wrong type returned from `type` when match after unknown extension
199 -
200 -1.0.6 / 2014-06-24
201 -==================
202 -
203 - * deps: negotiator@0.4.7
204 -
205 -1.0.5 / 2014-06-20
206 -==================
207 -
208 - * fix crash when unknown extension given
209 -
210 -1.0.4 / 2014-06-19
211 -==================
212 -
213 - * use `mime-types`
214 -
215 -1.0.3 / 2014-06-11
216 -==================
217 -
218 - * deps: negotiator@0.4.6
219 - - Order by specificity when quality is the same
220 -
221 -1.0.2 / 2014-05-29
222 -==================
223 -
224 - * Fix interpretation when header not in request
225 - * deps: pin negotiator@0.4.5
226 -
227 -1.0.1 / 2014-01-18
228 -==================
229 -
230 - * Identity encoding isn't always acceptable
231 - * deps: negotiator@~0.4.0
232 -
233 -1.0.0 / 2013-12-27
234 -==================
235 -
236 - * Genesis
1 -(The MIT License)
2 -
3 -Copyright (c) 2014 Jonathan Ong <me@jongleberry.com>
4 -Copyright (c) 2015 Douglas Christopher Wilson <doug@somethingdoug.com>
5 -
6 -Permission is hereby granted, free of charge, to any person obtaining
7 -a copy of this software and associated documentation files (the
8 -'Software'), to deal in the Software without restriction, including
9 -without limitation the rights to use, copy, modify, merge, publish,
10 -distribute, sublicense, and/or sell copies of the Software, and to
11 -permit persons to whom the Software is furnished to do so, subject to
12 -the following conditions:
13 -
14 -The above copyright notice and this permission notice shall be
15 -included in all copies or substantial portions of the Software.
16 -
17 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
18 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
21 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1 -# accepts
2 -
3 -[![NPM Version][npm-version-image]][npm-url]
4 -[![NPM Downloads][npm-downloads-image]][npm-url]
5 -[![Node.js Version][node-version-image]][node-version-url]
6 -[![Build Status][travis-image]][travis-url]
7 -[![Test Coverage][coveralls-image]][coveralls-url]
8 -
9 -Higher level content negotiation based on [negotiator](https://www.npmjs.com/package/negotiator).
10 -Extracted from [koa](https://www.npmjs.com/package/koa) for general use.
11 -
12 -In addition to negotiator, it allows:
13 -
14 -- Allows types as an array or arguments list, ie `(['text/html', 'application/json'])`
15 - as well as `('text/html', 'application/json')`.
16 -- Allows type shorthands such as `json`.
17 -- Returns `false` when no types match
18 -- Treats non-existent headers as `*`
19 -
20 -## Installation
21 -
22 -This is a [Node.js](https://nodejs.org/en/) module available through the
23 -[npm registry](https://www.npmjs.com/). Installation is done using the
24 -[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
25 -
26 -```sh
27 -$ npm install accepts
28 -```
29 -
30 -## API
31 -
32 -<!-- eslint-disable no-unused-vars -->
33 -
34 -```js
35 -var accepts = require('accepts')
36 -```
37 -
38 -### accepts(req)
39 -
40 -Create a new `Accepts` object for the given `req`.
41 -
42 -#### .charset(charsets)
43 -
44 -Return the first accepted charset. If nothing in `charsets` is accepted,
45 -then `false` is returned.
46 -
47 -#### .charsets()
48 -
49 -Return the charsets that the request accepts, in the order of the client's
50 -preference (most preferred first).
51 -
52 -#### .encoding(encodings)
53 -
54 -Return the first accepted encoding. If nothing in `encodings` is accepted,
55 -then `false` is returned.
56 -
57 -#### .encodings()
58 -
59 -Return the encodings that the request accepts, in the order of the client's
60 -preference (most preferred first).
61 -
62 -#### .language(languages)
63 -
64 -Return the first accepted language. If nothing in `languages` is accepted,
65 -then `false` is returned.
66 -
67 -#### .languages()
68 -
69 -Return the languages that the request accepts, in the order of the client's
70 -preference (most preferred first).
71 -
72 -#### .type(types)
73 -
74 -Return the first accepted type (and it is returned as the same text as what
75 -appears in the `types` array). If nothing in `types` is accepted, then `false`
76 -is returned.
77 -
78 -The `types` array can contain full MIME types or file extensions. Any value
79 -that is not a full MIME types is passed to `require('mime-types').lookup`.
80 -
81 -#### .types()
82 -
83 -Return the types that the request accepts, in the order of the client's
84 -preference (most preferred first).
85 -
86 -## Examples
87 -
88 -### Simple type negotiation
89 -
90 -This simple example shows how to use `accepts` to return a different typed
91 -respond body based on what the client wants to accept. The server lists it's
92 -preferences in order and will get back the best match between the client and
93 -server.
94 -
95 -```js
96 -var accepts = require('accepts')
97 -var http = require('http')
98 -
99 -function app (req, res) {
100 - var accept = accepts(req)
101 -
102 - // the order of this list is significant; should be server preferred order
103 - switch (accept.type(['json', 'html'])) {
104 - case 'json':
105 - res.setHeader('Content-Type', 'application/json')
106 - res.write('{"hello":"world!"}')
107 - break
108 - case 'html':
109 - res.setHeader('Content-Type', 'text/html')
110 - res.write('<b>hello, world!</b>')
111 - break
112 - default:
113 - // the fallback is text/plain, so no need to specify it above
114 - res.setHeader('Content-Type', 'text/plain')
115 - res.write('hello, world!')
116 - break
117 - }
118 -
119 - res.end()
120 -}
121 -
122 -http.createServer(app).listen(3000)
123 -```
124 -
125 -You can test this out with the cURL program:
126 -```sh
127 -curl -I -H'Accept: text/html' http://localhost:3000/
128 -```
129 -
130 -## License
131 -
132 -[MIT](LICENSE)
133 -
134 -[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/accepts/master
135 -[coveralls-url]: https://coveralls.io/r/jshttp/accepts?branch=master
136 -[node-version-image]: https://badgen.net/npm/node/accepts
137 -[node-version-url]: https://nodejs.org/en/download
138 -[npm-downloads-image]: https://badgen.net/npm/dm/accepts
139 -[npm-url]: https://npmjs.org/package/accepts
140 -[npm-version-image]: https://badgen.net/npm/v/accepts
141 -[travis-image]: https://badgen.net/travis/jshttp/accepts/master
142 -[travis-url]: https://travis-ci.org/jshttp/accepts
1 -/*!
2 - * accepts
3 - * Copyright(c) 2014 Jonathan Ong
4 - * Copyright(c) 2015 Douglas Christopher Wilson
5 - * MIT Licensed
6 - */
7 -
8 -'use strict'
9 -
10 -/**
11 - * Module dependencies.
12 - * @private
13 - */
14 -
15 -var Negotiator = require('negotiator')
16 -var mime = require('mime-types')
17 -
18 -/**
19 - * Module exports.
20 - * @public
21 - */
22 -
23 -module.exports = Accepts
24 -
25 -/**
26 - * Create a new Accepts object for the given req.
27 - *
28 - * @param {object} req
29 - * @public
30 - */
31 -
32 -function Accepts (req) {
33 - if (!(this instanceof Accepts)) {
34 - return new Accepts(req)
35 - }
36 -
37 - this.headers = req.headers
38 - this.negotiator = new Negotiator(req)
39 -}
40 -
41 -/**
42 - * Check if the given `type(s)` is acceptable, returning
43 - * the best match when true, otherwise `undefined`, in which
44 - * case you should respond with 406 "Not Acceptable".
45 - *
46 - * The `type` value may be a single mime type string
47 - * such as "application/json", the extension name
48 - * such as "json" or an array `["json", "html", "text/plain"]`. When a list
49 - * or array is given the _best_ match, if any is returned.
50 - *
51 - * Examples:
52 - *
53 - * // Accept: text/html
54 - * this.types('html');
55 - * // => "html"
56 - *
57 - * // Accept: text/*, application/json
58 - * this.types('html');
59 - * // => "html"
60 - * this.types('text/html');
61 - * // => "text/html"
62 - * this.types('json', 'text');
63 - * // => "json"
64 - * this.types('application/json');
65 - * // => "application/json"
66 - *
67 - * // Accept: text/*, application/json
68 - * this.types('image/png');
69 - * this.types('png');
70 - * // => undefined
71 - *
72 - * // Accept: text/*;q=.5, application/json
73 - * this.types(['html', 'json']);
74 - * this.types('html', 'json');
75 - * // => "json"
76 - *
77 - * @param {String|Array} types...
78 - * @return {String|Array|Boolean}
79 - * @public
80 - */
81 -
82 -Accepts.prototype.type =
83 -Accepts.prototype.types = function (types_) {
84 - var types = types_
85 -
86 - // support flattened arguments
87 - if (types && !Array.isArray(types)) {
88 - types = new Array(arguments.length)
89 - for (var i = 0; i < types.length; i++) {
90 - types[i] = arguments[i]
91 - }
92 - }
93 -
94 - // no types, return all requested types
95 - if (!types || types.length === 0) {
96 - return this.negotiator.mediaTypes()
97 - }
98 -
99 - // no accept header, return first given type
100 - if (!this.headers.accept) {
101 - return types[0]
102 - }
103 -
104 - var mimes = types.map(extToMime)
105 - var accepts = this.negotiator.mediaTypes(mimes.filter(validMime))
106 - var first = accepts[0]
107 -
108 - return first
109 - ? types[mimes.indexOf(first)]
110 - : false
111 -}
112 -
113 -/**
114 - * Return accepted encodings or best fit based on `encodings`.
115 - *
116 - * Given `Accept-Encoding: gzip, deflate`
117 - * an array sorted by quality is returned:
118 - *
119 - * ['gzip', 'deflate']
120 - *
121 - * @param {String|Array} encodings...
122 - * @return {String|Array}
123 - * @public
124 - */
125 -
126 -Accepts.prototype.encoding =
127 -Accepts.prototype.encodings = function (encodings_) {
128 - var encodings = encodings_
129 -
130 - // support flattened arguments
131 - if (encodings && !Array.isArray(encodings)) {
132 - encodings = new Array(arguments.length)
133 - for (var i = 0; i < encodings.length; i++) {
134 - encodings[i] = arguments[i]
135 - }
136 - }
137 -
138 - // no encodings, return all requested encodings
139 - if (!encodings || encodings.length === 0) {
140 - return this.negotiator.encodings()
141 - }
142 -
143 - return this.negotiator.encodings(encodings)[0] || false
144 -}
145 -
146 -/**
147 - * Return accepted charsets or best fit based on `charsets`.
148 - *
149 - * Given `Accept-Charset: utf-8, iso-8859-1;q=0.2, utf-7;q=0.5`
150 - * an array sorted by quality is returned:
151 - *
152 - * ['utf-8', 'utf-7', 'iso-8859-1']
153 - *
154 - * @param {String|Array} charsets...
155 - * @return {String|Array}
156 - * @public
157 - */
158 -
159 -Accepts.prototype.charset =
160 -Accepts.prototype.charsets = function (charsets_) {
161 - var charsets = charsets_
162 -
163 - // support flattened arguments
164 - if (charsets && !Array.isArray(charsets)) {
165 - charsets = new Array(arguments.length)
166 - for (var i = 0; i < charsets.length; i++) {
167 - charsets[i] = arguments[i]
168 - }
169 - }
170 -
171 - // no charsets, return all requested charsets
172 - if (!charsets || charsets.length === 0) {
173 - return this.negotiator.charsets()
174 - }
175 -
176 - return this.negotiator.charsets(charsets)[0] || false
177 -}
178 -
179 -/**
180 - * Return accepted languages or best fit based on `langs`.
181 - *
182 - * Given `Accept-Language: en;q=0.8, es, pt`
183 - * an array sorted by quality is returned:
184 - *
185 - * ['es', 'pt', 'en']
186 - *
187 - * @param {String|Array} langs...
188 - * @return {Array|String}
189 - * @public
190 - */
191 -
192 -Accepts.prototype.lang =
193 -Accepts.prototype.langs =
194 -Accepts.prototype.language =
195 -Accepts.prototype.languages = function (languages_) {
196 - var languages = languages_
197 -
198 - // support flattened arguments
199 - if (languages && !Array.isArray(languages)) {
200 - languages = new Array(arguments.length)
201 - for (var i = 0; i < languages.length; i++) {
202 - languages[i] = arguments[i]
203 - }
204 - }
205 -
206 - // no languages, return all requested languages
207 - if (!languages || languages.length === 0) {
208 - return this.negotiator.languages()
209 - }
210 -
211 - return this.negotiator.languages(languages)[0] || false
212 -}
213 -
214 -/**
215 - * Convert extnames to mime.
216 - *
217 - * @param {String} type
218 - * @return {String}
219 - * @private
220 - */
221 -
222 -function extToMime (type) {
223 - return type.indexOf('/') === -1
224 - ? mime.lookup(type)
225 - : type
226 -}
227 -
228 -/**
229 - * Check if mime is valid.
230 - *
231 - * @param {String} type
232 - * @return {String}
233 - * @private
234 - */
235 -
236 -function validMime (type) {
237 - return typeof type === 'string'
238 -}
1 -{
2 - "_args": [
3 - [
4 - "accepts@1.3.7",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "accepts@1.3.7",
9 - "_id": "accepts@1.3.7",
10 - "_inBundle": false,
11 - "_integrity": "sha512-Il80Qs2WjYlJIBNzNkK6KYqlVMTbZLXgHx2oT0pU/fjRHyEp+PEfEPY0R3WCwAGVOtauxh1hOxNgIf5bv7dQpA==",
12 - "_location": "/accepts",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "accepts@1.3.7",
18 - "name": "accepts",
19 - "escapedName": "accepts",
20 - "rawSpec": "1.3.7",
21 - "saveSpec": null,
22 - "fetchSpec": "1.3.7"
23 - },
24 - "_requiredBy": [
25 - "/express"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.7.tgz",
28 - "_spec": "1.3.7",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "bugs": {
31 - "url": "https://github.com/jshttp/accepts/issues"
32 - },
33 - "contributors": [
34 - {
35 - "name": "Douglas Christopher Wilson",
36 - "email": "doug@somethingdoug.com"
37 - },
38 - {
39 - "name": "Jonathan Ong",
40 - "email": "me@jongleberry.com",
41 - "url": "http://jongleberry.com"
42 - }
43 - ],
44 - "dependencies": {
45 - "mime-types": "~2.1.24",
46 - "negotiator": "0.6.2"
47 - },
48 - "description": "Higher-level content negotiation",
49 - "devDependencies": {
50 - "deep-equal": "1.0.1",
51 - "eslint": "5.16.0",
52 - "eslint-config-standard": "12.0.0",
53 - "eslint-plugin-import": "2.17.2",
54 - "eslint-plugin-markdown": "1.0.0",
55 - "eslint-plugin-node": "8.0.1",
56 - "eslint-plugin-promise": "4.1.1",
57 - "eslint-plugin-standard": "4.0.0",
58 - "mocha": "6.1.4",
59 - "nyc": "14.0.0"
60 - },
61 - "engines": {
62 - "node": ">= 0.6"
63 - },
64 - "files": [
65 - "LICENSE",
66 - "HISTORY.md",
67 - "index.js"
68 - ],
69 - "homepage": "https://github.com/jshttp/accepts#readme",
70 - "keywords": [
71 - "content",
72 - "negotiation",
73 - "accept",
74 - "accepts"
75 - ],
76 - "license": "MIT",
77 - "name": "accepts",
78 - "repository": {
79 - "type": "git",
80 - "url": "git+https://github.com/jshttp/accepts.git"
81 - },
82 - "scripts": {
83 - "lint": "eslint --plugin markdown --ext js,md .",
84 - "test": "mocha --reporter spec --check-leaks --bail test/",
85 - "test-cov": "nyc --reporter=html --reporter=text npm test",
86 - "test-travis": "nyc --reporter=text npm test"
87 - },
88 - "version": "1.3.7"
89 -}
1 -The MIT License (MIT)
2 -
3 -Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com)
4 -
5 -Permission is hereby granted, free of charge, to any person obtaining a copy
6 -of this software and associated documentation files (the "Software"), to deal
7 -in the Software without restriction, including without limitation the rights
8 -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 -copies of the Software, and to permit persons to whom the Software is
10 -furnished to do so, subject to the following conditions:
11 -
12 -The above copyright notice and this permission notice shall be included in
13 -all copies or substantial portions of the Software.
14 -
15 -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 -THE SOFTWARE.
1 -# Array Flatten
2 -
3 -[![NPM version][npm-image]][npm-url]
4 -[![NPM downloads][downloads-image]][downloads-url]
5 -[![Build status][travis-image]][travis-url]
6 -[![Test coverage][coveralls-image]][coveralls-url]
7 -
8 -> Flatten an array of nested arrays into a single flat array. Accepts an optional depth.
9 -
10 -## Installation
11 -
12 -```
13 -npm install array-flatten --save
14 -```
15 -
16 -## Usage
17 -
18 -```javascript
19 -var flatten = require('array-flatten')
20 -
21 -flatten([1, [2, [3, [4, [5], 6], 7], 8], 9])
22 -//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]
23 -
24 -flatten([1, [2, [3, [4, [5], 6], 7], 8], 9], 2)
25 -//=> [1, 2, 3, [4, [5], 6], 7, 8, 9]
26 -
27 -(function () {
28 - flatten(arguments) //=> [1, 2, 3]
29 -})(1, [2, 3])
30 -```
31 -
32 -## License
33 -
34 -MIT
35 -
36 -[npm-image]: https://img.shields.io/npm/v/array-flatten.svg?style=flat
37 -[npm-url]: https://npmjs.org/package/array-flatten
38 -[downloads-image]: https://img.shields.io/npm/dm/array-flatten.svg?style=flat
39 -[downloads-url]: https://npmjs.org/package/array-flatten
40 -[travis-image]: https://img.shields.io/travis/blakeembrey/array-flatten.svg?style=flat
41 -[travis-url]: https://travis-ci.org/blakeembrey/array-flatten
42 -[coveralls-image]: https://img.shields.io/coveralls/blakeembrey/array-flatten.svg?style=flat
43 -[coveralls-url]: https://coveralls.io/r/blakeembrey/array-flatten?branch=master
1 -'use strict'
2 -
3 -/**
4 - * Expose `arrayFlatten`.
5 - */
6 -module.exports = arrayFlatten
7 -
8 -/**
9 - * Recursive flatten function with depth.
10 - *
11 - * @param {Array} array
12 - * @param {Array} result
13 - * @param {Number} depth
14 - * @return {Array}
15 - */
16 -function flattenWithDepth (array, result, depth) {
17 - for (var i = 0; i < array.length; i++) {
18 - var value = array[i]
19 -
20 - if (depth > 0 && Array.isArray(value)) {
21 - flattenWithDepth(value, result, depth - 1)
22 - } else {
23 - result.push(value)
24 - }
25 - }
26 -
27 - return result
28 -}
29 -
30 -/**
31 - * Recursive flatten function. Omitting depth is slightly faster.
32 - *
33 - * @param {Array} array
34 - * @param {Array} result
35 - * @return {Array}
36 - */
37 -function flattenForever (array, result) {
38 - for (var i = 0; i < array.length; i++) {
39 - var value = array[i]
40 -
41 - if (Array.isArray(value)) {
42 - flattenForever(value, result)
43 - } else {
44 - result.push(value)
45 - }
46 - }
47 -
48 - return result
49 -}
50 -
51 -/**
52 - * Flatten an array, with the ability to define a depth.
53 - *
54 - * @param {Array} array
55 - * @param {Number} depth
56 - * @return {Array}
57 - */
58 -function arrayFlatten (array, depth) {
59 - if (depth == null) {
60 - return flattenForever(array, [])
61 - }
62 -
63 - return flattenWithDepth(array, [], depth)
64 -}
1 -{
2 - "_args": [
3 - [
4 - "array-flatten@1.1.1",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "array-flatten@1.1.1",
9 - "_id": "array-flatten@1.1.1",
10 - "_inBundle": false,
11 - "_integrity": "sha1-ml9pkFGx5wczKPKgCJaLZOopVdI=",
12 - "_location": "/array-flatten",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "array-flatten@1.1.1",
18 - "name": "array-flatten",
19 - "escapedName": "array-flatten",
20 - "rawSpec": "1.1.1",
21 - "saveSpec": null,
22 - "fetchSpec": "1.1.1"
23 - },
24 - "_requiredBy": [
25 - "/express"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
28 - "_spec": "1.1.1",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "author": {
31 - "name": "Blake Embrey",
32 - "email": "hello@blakeembrey.com",
33 - "url": "http://blakeembrey.me"
34 - },
35 - "bugs": {
36 - "url": "https://github.com/blakeembrey/array-flatten/issues"
37 - },
38 - "description": "Flatten an array of nested arrays into a single flat array",
39 - "devDependencies": {
40 - "istanbul": "^0.3.13",
41 - "mocha": "^2.2.4",
42 - "pre-commit": "^1.0.7",
43 - "standard": "^3.7.3"
44 - },
45 - "files": [
46 - "array-flatten.js",
47 - "LICENSE"
48 - ],
49 - "homepage": "https://github.com/blakeembrey/array-flatten",
50 - "keywords": [
51 - "array",
52 - "flatten",
53 - "arguments",
54 - "depth"
55 - ],
56 - "license": "MIT",
57 - "main": "array-flatten.js",
58 - "name": "array-flatten",
59 - "repository": {
60 - "type": "git",
61 - "url": "git://github.com/blakeembrey/array-flatten.git"
62 - },
63 - "scripts": {
64 - "test": "istanbul cover _mocha -- -R spec"
65 - },
66 - "version": "1.1.1"
67 -}
1 -#### 9.0.0
2 -* 27/05/2019
3 -* For compatibility with legacy browsers, remove `Symbol` references.
4 -
5 -#### 8.1.1
6 -* 24/02/2019
7 -* [BUGFIX] #222 Restore missing `var` to `export BigNumber`.
8 -* Allow any key in BigNumber.Instance in *bignumber.d.ts*.
9 -
10 -#### 8.1.0
11 -* 23/02/2019
12 -* [NEW FEATURE] #220 Create a BigNumber using `{s, e, c}`.
13 -* [NEW FEATURE] `isBigNumber`: if `BigNumber.DEBUG` is `true`, also check that the BigNumber instance is well-formed.
14 -* Remove `instanceof` checks; just use `_isBigNumber` to identify a BigNumber instance.
15 -* Add `_isBigNumber` to prototype in *bignumber.mjs*.
16 -* Add tests for BigNumber creation from object.
17 -* Update *API.html*.
18 -
19 -#### 8.0.2
20 -* 13/01/2019
21 -* #209 `toPrecision` without argument should follow `toString`.
22 -* Improve *Use* section of *README*.
23 -* Optimise `toString(10)`.
24 -* Add verson number to API doc.
25 -
26 -#### 8.0.1
27 -* 01/11/2018
28 -* Rest parameter must be array type in *bignumber.d.ts*.
29 -
30 -#### 8.0.0
31 -* 01/11/2018
32 -* [NEW FEATURE] Add `BigNumber.sum` method.
33 -* [NEW FEATURE]`toFormat`: add `prefix` and `suffix` options.
34 -* [NEW FEATURE] #178 Pass custom formatting to `toFormat`.
35 -* [BREAKING CHANGE] #184 `toFraction`: return array of BigNumbers not strings.
36 -* [NEW FEATURE] #185 Enable overwrite of `valueOf` to prevent accidental addition to string.
37 -* #183 Add Node.js `crypto` requirement to documentation.
38 -* [BREAKING CHANGE] #198 Disallow signs and whitespace in custom alphabet.
39 -* [NEW FEATURE] #188 Implement `util.inspect.custom` for Node.js REPL.
40 -* #170 Make `isBigNumber` a type guard in *bignumber.d.ts*.
41 -* [BREAKING CHANGE] `BigNumber.min` and `BigNumber.max`: don't accept an array.
42 -* Update *.travis.yml*.
43 -* Remove *bower.json*.
44 -
45 -#### 7.2.1
46 -* 24/05/2018
47 -* Add `browser` field to *package.json*.
48 -
49 -#### 7.2.0
50 -* 22/05/2018
51 -* #166 Correct *.mjs* file. Remove extension from `main` field in *package.json*.
52 -
53 -#### 7.1.0
54 -* 18/05/2018
55 -* Add `module` field to *package.json* for *bignumber.mjs*.
56 -
57 -#### 7.0.2
58 -* 17/05/2018
59 -* #165 Bugfix: upper-case letters for bases 11-36 in a custom alphabet.
60 -* Add note to *README* regarding creating BigNumbers from Number values.
61 -
62 -#### 7.0.1
63 -* 26/04/2018
64 -* #158 Fix global object variable name typo.
65 -
66 -#### 7.0.0
67 -* 26/04/2018
68 -* #143 Remove global BigNumber from typings.
69 -* #144 Enable compatibility with `Object.freeze(Object.prototype)`.
70 -* #148 #123 #11 Only throw on a number primitive with more than 15 significant digits if `BigNumber.DEBUG` is `true`.
71 -* Only throw on an invalid BigNumber value if `BigNumber.DEBUG` is `true`. Return BigNumber `NaN` instead.
72 -* #154 `exponentiatedBy`: allow BigNumber exponent.
73 -* #156 Prevent Content Security Policy *unsafe-eval* issue.
74 -* `toFraction`: allow `Infinity` maximum denominator.
75 -* Comment-out some excess tests to reduce test time.
76 -* Amend indentation and other spacing.
77 -
78 -#### 6.0.0
79 -* 26/01/2018
80 -* #137 Implement `APLHABET` configuration option.
81 -* Remove `ERRORS` configuration option.
82 -* Remove `toDigits` method; extend `precision` method accordingly.
83 -* Remove s`round` method; extend `decimalPlaces` method accordingly.
84 -* Remove methods: `ceil`, `floor`, and `truncated`.
85 -* Remove method aliases: `add`, `cmp`, `isInt`, `isNeg`, `trunc`, `mul`, `neg` and `sub`.
86 -* Rename methods: `shift` to `shiftedBy`, `another` to `clone`, `toPower` to `exponentiatedBy`, and `equals` to `isEqualTo`.
87 -* Rename methods: add `is` prefix to `greaterThan`, `greaterThanOrEqualTo`, `lessThan` and `lessThanOrEqualTo`.
88 -* Add methods: `multipliedBy`, `isBigNumber`, `isPositive`, `integerValue`, `maximum` and `minimum`.
89 -* Refactor test suite.
90 -* Add *CHANGELOG.md*.
91 -* Rewrite *bignumber.d.ts*.
92 -* Redo API image.
93 -
94 -#### 5.0.0
95 -* 27/11/2017
96 -* #81 Don't throw on constructor call without `new`.
97 -
98 -#### 4.1.0
99 -* 26/09/2017
100 -* Remove node 0.6 from *.travis.yml*.
101 -* Add *bignumber.mjs*.
102 -
103 -#### 4.0.4
104 -* 03/09/2017
105 -* Add missing aliases to *bignumber.d.ts*.
106 -
107 -#### 4.0.3
108 -* 30/08/2017
109 -* Add types: *bignumber.d.ts*.
110 -
111 -#### 4.0.2
112 -* 03/05/2017
113 -* #120 Workaround Safari/Webkit bug.
114 -
115 -#### 4.0.1
116 -* 05/04/2017
117 -* #121 BigNumber.default to BigNumber['default'].
118 -
119 -#### 4.0.0
120 -* 09/01/2017
121 -* Replace BigNumber.isBigNumber method with isBigNumber prototype property.
122 -
123 -#### 3.1.2
124 -* 08/01/2017
125 -* Minor documentation edit.
126 -
127 -#### 3.1.1
128 -* 08/01/2017
129 -* Uncomment `isBigNumber` tests.
130 -* Ignore dot files.
131 -
132 -#### 3.1.0
133 -* 08/01/2017
134 -* Add `isBigNumber` method.
135 -
136 -#### 3.0.2
137 -* 08/01/2017
138 -* Bugfix: Possible incorrect value of `ERRORS` after a `BigNumber.another` call (due to `parseNumeric` declaration in outer scope).
139 -
140 -#### 3.0.1
141 -* 23/11/2016
142 -* Apply fix for old ipads with `%` issue, see #57 and #102.
143 -* Correct error message.
144 -
145 -#### 3.0.0
146 -* 09/11/2016
147 -* Remove `require('crypto')` - leave it to the user.
148 -* Add `BigNumber.set` as `BigNumber.config` alias.
149 -* Default `POW_PRECISION` to `0`.
150 -
151 -#### 2.4.0
152 -* 14/07/2016
153 -* #97 Add exports to support ES6 imports.
154 -
155 -#### 2.3.0
156 -* 07/03/2016
157 -* #86 Add modulus parameter to `toPower`.
158 -
159 -#### 2.2.0
160 -* 03/03/2016
161 -* #91 Permit larger JS integers.
162 -
163 -#### 2.1.4
164 -* 15/12/2015
165 -* Correct UMD.
166 -
167 -#### 2.1.3
168 -* 13/12/2015
169 -* Refactor re global object and crypto availability when bundling.
170 -
171 -#### 2.1.2
172 -* 10/12/2015
173 -* Bugfix: `window.crypto` not assigned to `crypto`.
174 -
175 -#### 2.1.1
176 -* 09/12/2015
177 -* Prevent code bundler from adding `crypto` shim.
178 -
179 -#### 2.1.0
180 -* 26/10/2015
181 -* For `valueOf` and `toJSON`, include the minus sign with negative zero.
182 -
183 -#### 2.0.8
184 -* 2/10/2015
185 -* Internal round function bugfix.
186 -
187 -#### 2.0.6
188 -* 31/03/2015
189 -* Add bower.json. Tweak division after in-depth review.
190 -
191 -#### 2.0.5
192 -* 25/03/2015
193 -* Amend README. Remove bitcoin address.
194 -
195 -#### 2.0.4
196 -* 25/03/2015
197 -* Critical bugfix #58: division.
198 -
199 -#### 2.0.3
200 -* 18/02/2015
201 -* Amend README. Add source map.
202 -
203 -#### 2.0.2
204 -* 18/02/2015
205 -* Correct links.
206 -
207 -#### 2.0.1
208 -* 18/02/2015
209 -* Add `max`, `min`, `precision`, `random`, `shiftedBy`, `toDigits` and `truncated` methods.
210 -* Add the short-forms: `add`, `mul`, `sd`, `sub` and `trunc`.
211 -* Add an `another` method to enable multiple independent constructors to be created.
212 -* Add support for the base 2, 8 and 16 prefixes `0b`, `0o` and `0x`.
213 -* Enable a rounding mode to be specified as a second parameter to `toExponential`, `toFixed`, `toFormat` and `toPrecision`.
214 -* Add a `CRYPTO` configuration property so cryptographically-secure pseudo-random number generation can be specified.
215 -* Add a `MODULO_MODE` configuration property to enable the rounding mode used by the `modulo` operation to be specified.
216 -* Add a `POW_PRECISION` configuration property to enable the number of significant digits calculated by the power operation to be limited.
217 -* Improve code quality.
218 -* Improve documentation.
219 -
220 -#### 2.0.0
221 -* 29/12/2014
222 -* Add `dividedToIntegerBy`, `isInteger` and `toFormat` methods.
223 -* Remove the following short-forms: `isF`, `isZ`, `toE`, `toF`, `toFr`, `toN`, `toP`, `toS`.
224 -* Store a BigNumber's coefficient in base 1e14, rather than base 10.
225 -* Add fast path for integers to BigNumber constructor.
226 -* Incorporate the library into the online documentation.
227 -
228 -#### 1.5.0
229 -* 13/11/2014
230 -* Add `toJSON` and `decimalPlaces` methods.
231 -
232 -#### 1.4.1
233 -* 08/06/2014
234 -* Amend README.
235 -
236 -#### 1.4.0
237 -* 08/05/2014
238 -* Add `toNumber`.
239 -
240 -#### 1.3.0
241 -* 08/11/2013
242 -* Ensure correct rounding of `sqrt` in all, rather than almost all, cases.
243 -* Maximum radix to 64.
244 -
245 -#### 1.2.1
246 -* 17/10/2013
247 -* Sign of zero when x < 0 and x + (-x) = 0.
248 -
249 -#### 1.2.0
250 -* 19/9/2013
251 -* Throw Error objects for stack.
252 -
253 -#### 1.1.1
254 -* 22/8/2013
255 -* Show original value in constructor error message.
256 -
257 -#### 1.1.0
258 -* 1/8/2013
259 -* Allow numbers with trailing radix point.
260 -
261 -#### 1.0.1
262 -* Bugfix: error messages with incorrect method name
263 -
264 -#### 1.0.0
265 -* 8/11/2012
266 -* Initial release
1 -The MIT Licence.
2 -
3 -Copyright (c) 2019 Michael Mclaughlin
4 -
5 -Permission is hereby granted, free of charge, to any person obtaining
6 -a copy of this software and associated documentation files (the
7 -'Software'), to deal in the Software without restriction, including
8 -without limitation the rights to use, copy, modify, merge, publish,
9 -distribute, sublicense, and/or sell copies of the Software, and to
10 -permit persons to whom the Software is furnished to do so, subject to
11 -the following conditions:
12 -
13 -The above copyright notice and this permission notice shall be
14 -included in all copies or substantial portions of the Software.
15 -
16 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 -
1 -![bignumber.js](https://raw.githubusercontent.com/MikeMcl/bignumber.js/gh-pages/bignumberjs.png)
2 -
3 -A JavaScript library for arbitrary-precision decimal and non-decimal arithmetic.
4 -
5 -[![Build Status](https://travis-ci.org/MikeMcl/bignumber.js.svg)](https://travis-ci.org/MikeMcl/bignumber.js)
6 -
7 -<br />
8 -
9 -## Features
10 -
11 - - Integers and decimals
12 - - Simple API but full-featured
13 - - Faster, smaller, and perhaps easier to use than JavaScript versions of Java's BigDecimal
14 - - 8 KB minified and gzipped
15 - - Replicates the `toExponential`, `toFixed`, `toPrecision` and `toString` methods of JavaScript's Number type
16 - - Includes a `toFraction` and a correctly-rounded `squareRoot` method
17 - - Supports cryptographically-secure pseudo-random number generation
18 - - No dependencies
19 - - Wide platform compatibility: uses JavaScript 1.5 (ECMAScript 3) features only
20 - - Comprehensive [documentation](http://mikemcl.github.io/bignumber.js/) and test set
21 -
22 -![API](https://raw.githubusercontent.com/MikeMcl/bignumber.js/gh-pages/API.png)
23 -
24 -If a smaller and simpler library is required see [big.js](https://github.com/MikeMcl/big.js/).
25 -It's less than half the size but only works with decimal numbers and only has half the methods.
26 -It also does not allow `NaN` or `Infinity`, or have the configuration options of this library.
27 -
28 -See also [decimal.js](https://github.com/MikeMcl/decimal.js/), which among other things adds support for non-integer powers, and performs all operations to a specified number of significant digits.
29 -
30 -## Load
31 -
32 -The library is the single JavaScript file *bignumber.js* (or minified, *bignumber.min.js*).
33 -
34 -Browser:
35 -
36 -```html
37 -<script src='path/to/bignumber.js'></script>
38 -```
39 -
40 -[Node.js](http://nodejs.org):
41 -
42 -```bash
43 -$ npm install bignumber.js
44 -```
45 -
46 -```javascript
47 -const BigNumber = require('bignumber.js');
48 -```
49 -
50 -ES6 module:
51 -
52 -```javascript
53 -import BigNumber from "./bignumber.mjs"
54 -```
55 -
56 -AMD loader libraries such as [requireJS](http://requirejs.org/):
57 -
58 -```javascript
59 -require(['bignumber'], function(BigNumber) {
60 - // Use BigNumber here in local scope. No global BigNumber.
61 -});
62 -```
63 -
64 -## Use
65 -
66 -The library exports a single constructor function, [`BigNumber`](http://mikemcl.github.io/bignumber.js/#bignumber), which accepts a value of type Number, String or BigNumber,
67 -
68 -```javascript
69 -let x = new BigNumber(123.4567);
70 -let y = BigNumber('123456.7e-3');
71 -let z = new BigNumber(x);
72 -x.isEqualTo(y) && y.isEqualTo(z) && x.isEqualTo(z); // true
73 -```
74 -
75 -To get the string value of a BigNumber use [`toString()`](http://mikemcl.github.io/bignumber.js/#toS) or [`toFixed()`](http://mikemcl.github.io/bignumber.js/#toFix). Using `toFixed()` prevents exponential notation being returned, no matter how large or small the value.
76 -
77 -```javascript
78 -let x = new BigNumber('1111222233334444555566');
79 -x.toString(); // "1.111222233334444555566e+21"
80 -x.toFixed(); // "1111222233334444555566"
81 -```
82 -
83 -If the limited precision of Number values is not well understood, it is recommended to create BigNumbers from String values rather than Number values to avoid a potential loss of precision.
84 -
85 -*In all further examples below, `let`, semicolons and `toString` calls are not shown. If a commented-out value is in quotes it means `toString` has been called on the preceding expression.*
86 -
87 -```javascript
88 -// Precision loss from using numeric literals with more than 15 significant digits.
89 -new BigNumber(1.0000000000000001) // '1'
90 -new BigNumber(88259496234518.57) // '88259496234518.56'
91 -new BigNumber(99999999999999999999) // '100000000000000000000'
92 -
93 -// Precision loss from using numeric literals outside the range of Number values.
94 -new BigNumber(2e+308) // 'Infinity'
95 -new BigNumber(1e-324) // '0'
96 -
97 -// Precision loss from the unexpected result of arithmetic with Number values.
98 -new BigNumber(0.7 + 0.1) // '0.7999999999999999'
99 -```
100 -
101 -When creating a BigNumber from a Number, note that a BigNumber is created from a Number's decimal `toString()` value not from its underlying binary value. If the latter is required, then pass the Number's `toString(2)` value and specify base 2.
102 -
103 -```javascript
104 -new BigNumber(Number.MAX_VALUE.toString(2), 2)
105 -```
106 -
107 -BigNumbers can be created from values in bases from 2 to 36. See [`ALPHABET`](http://mikemcl.github.io/bignumber.js/#alphabet) to extend this range.
108 -
109 -```javascript
110 -a = new BigNumber(1011, 2) // "11"
111 -b = new BigNumber('zz.9', 36) // "1295.25"
112 -c = a.plus(b) // "1306.25"
113 -```
114 -
115 -Performance is better if base 10 is NOT specified for decimal values. Only specify base 10 when it is desired that the number of decimal places of the input value be limited to the current [`DECIMAL_PLACES`](http://mikemcl.github.io/bignumber.js/#decimal-places) setting.
116 -
117 -A BigNumber is immutable in the sense that it is not changed by its methods.
118 -
119 -```javascript
120 -0.3 - 0.1 // 0.19999999999999998
121 -x = new BigNumber(0.3)
122 -x.minus(0.1) // "0.2"
123 -x // "0.3"
124 -```
125 -
126 -The methods that return a BigNumber can be chained.
127 -
128 -```javascript
129 -x.dividedBy(y).plus(z).times(9)
130 -x.times('1.23456780123456789e+9').plus(9876.5432321).dividedBy('4444562598.111772').integerValue()
131 -```
132 -
133 -Some of the longer method names have a shorter alias.
134 -
135 -```javascript
136 -x.squareRoot().dividedBy(y).exponentiatedBy(3).isEqualTo(x.sqrt().div(y).pow(3)) // true
137 -x.modulo(y).multipliedBy(z).eq(x.mod(y).times(z)) // true
138 -```
139 -
140 -As with JavaScript's Number type, there are [`toExponential`](http://mikemcl.github.io/bignumber.js/#toE), [`toFixed`](http://mikemcl.github.io/bignumber.js/#toFix) and [`toPrecision`](http://mikemcl.github.io/bignumber.js/#toP) methods.
141 -
142 -```javascript
143 -x = new BigNumber(255.5)
144 -x.toExponential(5) // "2.55500e+2"
145 -x.toFixed(5) // "255.50000"
146 -x.toPrecision(5) // "255.50"
147 -x.toNumber() // 255.5
148 -```
149 -
150 - A base can be specified for [`toString`](http://mikemcl.github.io/bignumber.js/#toS). Performance is better if base 10 is NOT specified, i.e. use `toString()` not `toString(10)`. Only specify base 10 when it is desired that the number of decimal places be limited to the current [`DECIMAL_PLACES`](http://mikemcl.github.io/bignumber.js/#decimal-places) setting.
151 -
152 - ```javascript
153 - x.toString(16) // "ff.8"
154 - ```
155 -
156 -There is a [`toFormat`](http://mikemcl.github.io/bignumber.js/#toFor) method which may be useful for internationalisation.
157 -
158 -```javascript
159 -y = new BigNumber('1234567.898765')
160 -y.toFormat(2) // "1,234,567.90"
161 -```
162 -
163 -The maximum number of decimal places of the result of an operation involving division (i.e. a division, square root, base conversion or negative power operation) is set using the `set` or `config` method of the `BigNumber` constructor.
164 -
165 -The other arithmetic operations always give the exact result.
166 -
167 -```javascript
168 -BigNumber.set({ DECIMAL_PLACES: 10, ROUNDING_MODE: 4 })
169 -
170 -x = new BigNumber(2)
171 -y = new BigNumber(3)
172 -z = x.dividedBy(y) // "0.6666666667"
173 -z.squareRoot() // "0.8164965809"
174 -z.exponentiatedBy(-3) // "3.3749999995"
175 -z.toString(2) // "0.1010101011"
176 -z.multipliedBy(z) // "0.44444444448888888889"
177 -z.multipliedBy(z).decimalPlaces(10) // "0.4444444445"
178 -```
179 -
180 -There is a [`toFraction`](http://mikemcl.github.io/bignumber.js/#toFr) method with an optional *maximum denominator* argument
181 -
182 -```javascript
183 -y = new BigNumber(355)
184 -pi = y.dividedBy(113) // "3.1415929204"
185 -pi.toFraction() // [ "7853982301", "2500000000" ]
186 -pi.toFraction(1000) // [ "355", "113" ]
187 -```
188 -
189 -and [`isNaN`](http://mikemcl.github.io/bignumber.js/#isNaN) and [`isFinite`](http://mikemcl.github.io/bignumber.js/#isF) methods, as `NaN` and `Infinity` are valid `BigNumber` values.
190 -
191 -```javascript
192 -x = new BigNumber(NaN) // "NaN"
193 -y = new BigNumber(Infinity) // "Infinity"
194 -x.isNaN() && !y.isNaN() && !x.isFinite() && !y.isFinite() // true
195 -```
196 -
197 -The value of a BigNumber is stored in a decimal floating point format in terms of a coefficient, exponent and sign.
198 -
199 -```javascript
200 -x = new BigNumber(-123.456);
201 -x.c // [ 123, 45600000000000 ] coefficient (i.e. significand)
202 -x.e // 2 exponent
203 -x.s // -1 sign
204 -```
205 -
206 -For advanced usage, multiple BigNumber constructors can be created, each with their own independent configuration.
207 -
208 -```javascript
209 -// Set DECIMAL_PLACES for the original BigNumber constructor
210 -BigNumber.set({ DECIMAL_PLACES: 10 })
211 -
212 -// Create another BigNumber constructor, optionally passing in a configuration object
213 -BN = BigNumber.clone({ DECIMAL_PLACES: 5 })
214 -
215 -x = new BigNumber(1)
216 -y = new BN(1)
217 -
218 -x.div(3) // '0.3333333333'
219 -y.div(3) // '0.33333'
220 -```
221 -
222 -For further information see the [API](http://mikemcl.github.io/bignumber.js/) reference in the *doc* directory.
223 -
224 -## Test
225 -
226 -The *test/modules* directory contains the test scripts for each method.
227 -
228 -The tests can be run with Node.js or a browser. For Node.js use
229 -
230 - $ npm test
231 -
232 -or
233 -
234 - $ node test/test
235 -
236 -To test a single method, use, for example
237 -
238 - $ node test/methods/toFraction
239 -
240 -For the browser, open *test/test.html*.
241 -
242 -## Build
243 -
244 -For Node, if [uglify-js](https://github.com/mishoo/UglifyJS2) is installed
245 -
246 - npm install uglify-js -g
247 -
248 -then
249 -
250 - npm run build
251 -
252 -will create *bignumber.min.js*.
253 -
254 -A source map will also be created in the root directory.
255 -
256 -## Feedback
257 -
258 -Open an issue, or email
259 -
260 -Michael
261 -
262 -<a href="mailto:M8ch88l@gmail.com">M8ch88l@gmail.com</a>
263 -
264 -## Licence
265 -
266 -The MIT Licence.
267 -
268 -See [LICENCE](https://github.com/MikeMcl/bignumber.js/blob/master/LICENCE).
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
1 -{
2 - "_args": [
3 - [
4 - "bignumber.js@9.0.0",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "bignumber.js@9.0.0",
9 - "_id": "bignumber.js@9.0.0",
10 - "_inBundle": false,
11 - "_integrity": "sha512-t/OYhhJ2SD+YGBQcjY8GzzDHEk9f3nerxjtfa6tlMXfe7frs/WozhvCNoGvpM0P3bNf3Gq5ZRMlGr5f3r4/N8A==",
12 - "_location": "/bignumber.js",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "bignumber.js@9.0.0",
18 - "name": "bignumber.js",
19 - "escapedName": "bignumber.js",
20 - "rawSpec": "9.0.0",
21 - "saveSpec": null,
22 - "fetchSpec": "9.0.0"
23 - },
24 - "_requiredBy": [
25 - "/mysql"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.0.0.tgz",
28 - "_spec": "9.0.0",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "author": {
31 - "name": "Michael Mclaughlin",
32 - "email": "M8ch88l@gmail.com"
33 - },
34 - "browser": "bignumber.js",
35 - "bugs": {
36 - "url": "https://github.com/MikeMcl/bignumber.js/issues"
37 - },
38 - "dependencies": {},
39 - "description": "A library for arbitrary-precision decimal and non-decimal arithmetic",
40 - "engines": {
41 - "node": "*"
42 - },
43 - "homepage": "https://github.com/MikeMcl/bignumber.js#readme",
44 - "keywords": [
45 - "arbitrary",
46 - "precision",
47 - "arithmetic",
48 - "big",
49 - "number",
50 - "decimal",
51 - "float",
52 - "biginteger",
53 - "bigdecimal",
54 - "bignumber",
55 - "bigint",
56 - "bignum"
57 - ],
58 - "license": "MIT",
59 - "main": "bignumber",
60 - "module": "bignumber.mjs",
61 - "name": "bignumber.js",
62 - "repository": {
63 - "type": "git",
64 - "url": "git+https://github.com/MikeMcl/bignumber.js.git"
65 - },
66 - "scripts": {
67 - "build": "uglifyjs bignumber.js --source-map -c -m -o bignumber.min.js",
68 - "test": "node test/test"
69 - },
70 - "types": "bignumber.d.ts",
71 - "version": "9.0.0"
72 -}
This diff is collapsed. Click to expand it.
1 -(The MIT License)
2 -
3 -Copyright (c) 2014 Jonathan Ong <me@jongleberry.com>
4 -Copyright (c) 2014-2015 Douglas Christopher Wilson <doug@somethingdoug.com>
5 -
6 -Permission is hereby granted, free of charge, to any person obtaining
7 -a copy of this software and associated documentation files (the
8 -'Software'), to deal in the Software without restriction, including
9 -without limitation the rights to use, copy, modify, merge, publish,
10 -distribute, sublicense, and/or sell copies of the Software, and to
11 -permit persons to whom the Software is furnished to do so, subject to
12 -the following conditions:
13 -
14 -The above copyright notice and this permission notice shall be
15 -included in all copies or substantial portions of the Software.
16 -
17 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
18 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
21 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This diff is collapsed. Click to expand it.
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
4 - * MIT Licensed
5 - */
6 -
7 -'use strict'
8 -
9 -/**
10 - * Module dependencies.
11 - * @private
12 - */
13 -
14 -var deprecate = require('depd')('body-parser')
15 -
16 -/**
17 - * Cache of loaded parsers.
18 - * @private
19 - */
20 -
21 -var parsers = Object.create(null)
22 -
23 -/**
24 - * @typedef Parsers
25 - * @type {function}
26 - * @property {function} json
27 - * @property {function} raw
28 - * @property {function} text
29 - * @property {function} urlencoded
30 - */
31 -
32 -/**
33 - * Module exports.
34 - * @type {Parsers}
35 - */
36 -
37 -exports = module.exports = deprecate.function(bodyParser,
38 - 'bodyParser: use individual json/urlencoded middlewares')
39 -
40 -/**
41 - * JSON parser.
42 - * @public
43 - */
44 -
45 -Object.defineProperty(exports, 'json', {
46 - configurable: true,
47 - enumerable: true,
48 - get: createParserGetter('json')
49 -})
50 -
51 -/**
52 - * Raw parser.
53 - * @public
54 - */
55 -
56 -Object.defineProperty(exports, 'raw', {
57 - configurable: true,
58 - enumerable: true,
59 - get: createParserGetter('raw')
60 -})
61 -
62 -/**
63 - * Text parser.
64 - * @public
65 - */
66 -
67 -Object.defineProperty(exports, 'text', {
68 - configurable: true,
69 - enumerable: true,
70 - get: createParserGetter('text')
71 -})
72 -
73 -/**
74 - * URL-encoded parser.
75 - * @public
76 - */
77 -
78 -Object.defineProperty(exports, 'urlencoded', {
79 - configurable: true,
80 - enumerable: true,
81 - get: createParserGetter('urlencoded')
82 -})
83 -
84 -/**
85 - * Create a middleware to parse json and urlencoded bodies.
86 - *
87 - * @param {object} [options]
88 - * @return {function}
89 - * @deprecated
90 - * @public
91 - */
92 -
93 -function bodyParser (options) {
94 - var opts = {}
95 -
96 - // exclude type option
97 - if (options) {
98 - for (var prop in options) {
99 - if (prop !== 'type') {
100 - opts[prop] = options[prop]
101 - }
102 - }
103 - }
104 -
105 - var _urlencoded = exports.urlencoded(opts)
106 - var _json = exports.json(opts)
107 -
108 - return function bodyParser (req, res, next) {
109 - _json(req, res, function (err) {
110 - if (err) return next(err)
111 - _urlencoded(req, res, next)
112 - })
113 - }
114 -}
115 -
116 -/**
117 - * Create a getter for loading a parser.
118 - * @private
119 - */
120 -
121 -function createParserGetter (name) {
122 - return function get () {
123 - return loadParser(name)
124 - }
125 -}
126 -
127 -/**
128 - * Load a parser module.
129 - * @private
130 - */
131 -
132 -function loadParser (parserName) {
133 - var parser = parsers[parserName]
134 -
135 - if (parser !== undefined) {
136 - return parser
137 - }
138 -
139 - // this uses a switch for static require analysis
140 - switch (parserName) {
141 - case 'json':
142 - parser = require('./lib/types/json')
143 - break
144 - case 'raw':
145 - parser = require('./lib/types/raw')
146 - break
147 - case 'text':
148 - parser = require('./lib/types/text')
149 - break
150 - case 'urlencoded':
151 - parser = require('./lib/types/urlencoded')
152 - break
153 - }
154 -
155 - // store to prevent invoking require()
156 - return (parsers[parserName] = parser)
157 -}
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
4 - * MIT Licensed
5 - */
6 -
7 -'use strict'
8 -
9 -/**
10 - * Module dependencies.
11 - * @private
12 - */
13 -
14 -var createError = require('http-errors')
15 -var getBody = require('raw-body')
16 -var iconv = require('iconv-lite')
17 -var onFinished = require('on-finished')
18 -var zlib = require('zlib')
19 -
20 -/**
21 - * Module exports.
22 - */
23 -
24 -module.exports = read
25 -
26 -/**
27 - * Read a request into a buffer and parse.
28 - *
29 - * @param {object} req
30 - * @param {object} res
31 - * @param {function} next
32 - * @param {function} parse
33 - * @param {function} debug
34 - * @param {object} options
35 - * @private
36 - */
37 -
38 -function read (req, res, next, parse, debug, options) {
39 - var length
40 - var opts = options
41 - var stream
42 -
43 - // flag as parsed
44 - req._body = true
45 -
46 - // read options
47 - var encoding = opts.encoding !== null
48 - ? opts.encoding
49 - : null
50 - var verify = opts.verify
51 -
52 - try {
53 - // get the content stream
54 - stream = contentstream(req, debug, opts.inflate)
55 - length = stream.length
56 - stream.length = undefined
57 - } catch (err) {
58 - return next(err)
59 - }
60 -
61 - // set raw-body options
62 - opts.length = length
63 - opts.encoding = verify
64 - ? null
65 - : encoding
66 -
67 - // assert charset is supported
68 - if (opts.encoding === null && encoding !== null && !iconv.encodingExists(encoding)) {
69 - return next(createError(415, 'unsupported charset "' + encoding.toUpperCase() + '"', {
70 - charset: encoding.toLowerCase(),
71 - type: 'charset.unsupported'
72 - }))
73 - }
74 -
75 - // read body
76 - debug('read body')
77 - getBody(stream, opts, function (error, body) {
78 - if (error) {
79 - var _error
80 -
81 - if (error.type === 'encoding.unsupported') {
82 - // echo back charset
83 - _error = createError(415, 'unsupported charset "' + encoding.toUpperCase() + '"', {
84 - charset: encoding.toLowerCase(),
85 - type: 'charset.unsupported'
86 - })
87 - } else {
88 - // set status code on error
89 - _error = createError(400, error)
90 - }
91 -
92 - // read off entire request
93 - stream.resume()
94 - onFinished(req, function onfinished () {
95 - next(createError(400, _error))
96 - })
97 - return
98 - }
99 -
100 - // verify
101 - if (verify) {
102 - try {
103 - debug('verify body')
104 - verify(req, res, body, encoding)
105 - } catch (err) {
106 - next(createError(403, err, {
107 - body: body,
108 - type: err.type || 'entity.verify.failed'
109 - }))
110 - return
111 - }
112 - }
113 -
114 - // parse
115 - var str = body
116 - try {
117 - debug('parse body')
118 - str = typeof body !== 'string' && encoding !== null
119 - ? iconv.decode(body, encoding)
120 - : body
121 - req.body = parse(str)
122 - } catch (err) {
123 - next(createError(400, err, {
124 - body: str,
125 - type: err.type || 'entity.parse.failed'
126 - }))
127 - return
128 - }
129 -
130 - next()
131 - })
132 -}
133 -
134 -/**
135 - * Get the content stream of the request.
136 - *
137 - * @param {object} req
138 - * @param {function} debug
139 - * @param {boolean} [inflate=true]
140 - * @return {object}
141 - * @api private
142 - */
143 -
144 -function contentstream (req, debug, inflate) {
145 - var encoding = (req.headers['content-encoding'] || 'identity').toLowerCase()
146 - var length = req.headers['content-length']
147 - var stream
148 -
149 - debug('content-encoding "%s"', encoding)
150 -
151 - if (inflate === false && encoding !== 'identity') {
152 - throw createError(415, 'content encoding unsupported', {
153 - encoding: encoding,
154 - type: 'encoding.unsupported'
155 - })
156 - }
157 -
158 - switch (encoding) {
159 - case 'deflate':
160 - stream = zlib.createInflate()
161 - debug('inflate body')
162 - req.pipe(stream)
163 - break
164 - case 'gzip':
165 - stream = zlib.createGunzip()
166 - debug('gunzip body')
167 - req.pipe(stream)
168 - break
169 - case 'identity':
170 - stream = req
171 - stream.length = length
172 - break
173 - default:
174 - throw createError(415, 'unsupported content encoding "' + encoding + '"', {
175 - encoding: encoding,
176 - type: 'encoding.unsupported'
177 - })
178 - }
179 -
180 - return stream
181 -}
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014 Jonathan Ong
4 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
5 - * MIT Licensed
6 - */
7 -
8 -'use strict'
9 -
10 -/**
11 - * Module dependencies.
12 - * @private
13 - */
14 -
15 -var bytes = require('bytes')
16 -var contentType = require('content-type')
17 -var createError = require('http-errors')
18 -var debug = require('debug')('body-parser:json')
19 -var read = require('../read')
20 -var typeis = require('type-is')
21 -
22 -/**
23 - * Module exports.
24 - */
25 -
26 -module.exports = json
27 -
28 -/**
29 - * RegExp to match the first non-space in a string.
30 - *
31 - * Allowed whitespace is defined in RFC 7159:
32 - *
33 - * ws = *(
34 - * %x20 / ; Space
35 - * %x09 / ; Horizontal tab
36 - * %x0A / ; Line feed or New line
37 - * %x0D ) ; Carriage return
38 - */
39 -
40 -var FIRST_CHAR_REGEXP = /^[\x20\x09\x0a\x0d]*(.)/ // eslint-disable-line no-control-regex
41 -
42 -/**
43 - * Create a middleware to parse JSON bodies.
44 - *
45 - * @param {object} [options]
46 - * @return {function}
47 - * @public
48 - */
49 -
50 -function json (options) {
51 - var opts = options || {}
52 -
53 - var limit = typeof opts.limit !== 'number'
54 - ? bytes.parse(opts.limit || '100kb')
55 - : opts.limit
56 - var inflate = opts.inflate !== false
57 - var reviver = opts.reviver
58 - var strict = opts.strict !== false
59 - var type = opts.type || 'application/json'
60 - var verify = opts.verify || false
61 -
62 - if (verify !== false && typeof verify !== 'function') {
63 - throw new TypeError('option verify must be function')
64 - }
65 -
66 - // create the appropriate type checking function
67 - var shouldParse = typeof type !== 'function'
68 - ? typeChecker(type)
69 - : type
70 -
71 - function parse (body) {
72 - if (body.length === 0) {
73 - // special-case empty json body, as it's a common client-side mistake
74 - // TODO: maybe make this configurable or part of "strict" option
75 - return {}
76 - }
77 -
78 - if (strict) {
79 - var first = firstchar(body)
80 -
81 - if (first !== '{' && first !== '[') {
82 - debug('strict violation')
83 - throw createStrictSyntaxError(body, first)
84 - }
85 - }
86 -
87 - try {
88 - debug('parse json')
89 - return JSON.parse(body, reviver)
90 - } catch (e) {
91 - throw normalizeJsonSyntaxError(e, {
92 - message: e.message,
93 - stack: e.stack
94 - })
95 - }
96 - }
97 -
98 - return function jsonParser (req, res, next) {
99 - if (req._body) {
100 - debug('body already parsed')
101 - next()
102 - return
103 - }
104 -
105 - req.body = req.body || {}
106 -
107 - // skip requests without bodies
108 - if (!typeis.hasBody(req)) {
109 - debug('skip empty body')
110 - next()
111 - return
112 - }
113 -
114 - debug('content-type %j', req.headers['content-type'])
115 -
116 - // determine if request should be parsed
117 - if (!shouldParse(req)) {
118 - debug('skip parsing')
119 - next()
120 - return
121 - }
122 -
123 - // assert charset per RFC 7159 sec 8.1
124 - var charset = getCharset(req) || 'utf-8'
125 - if (charset.substr(0, 4) !== 'utf-') {
126 - debug('invalid charset')
127 - next(createError(415, 'unsupported charset "' + charset.toUpperCase() + '"', {
128 - charset: charset,
129 - type: 'charset.unsupported'
130 - }))
131 - return
132 - }
133 -
134 - // read
135 - read(req, res, next, parse, debug, {
136 - encoding: charset,
137 - inflate: inflate,
138 - limit: limit,
139 - verify: verify
140 - })
141 - }
142 -}
143 -
144 -/**
145 - * Create strict violation syntax error matching native error.
146 - *
147 - * @param {string} str
148 - * @param {string} char
149 - * @return {Error}
150 - * @private
151 - */
152 -
153 -function createStrictSyntaxError (str, char) {
154 - var index = str.indexOf(char)
155 - var partial = str.substring(0, index) + '#'
156 -
157 - try {
158 - JSON.parse(partial); /* istanbul ignore next */ throw new SyntaxError('strict violation')
159 - } catch (e) {
160 - return normalizeJsonSyntaxError(e, {
161 - message: e.message.replace('#', char),
162 - stack: e.stack
163 - })
164 - }
165 -}
166 -
167 -/**
168 - * Get the first non-whitespace character in a string.
169 - *
170 - * @param {string} str
171 - * @return {function}
172 - * @private
173 - */
174 -
175 -function firstchar (str) {
176 - return FIRST_CHAR_REGEXP.exec(str)[1]
177 -}
178 -
179 -/**
180 - * Get the charset of a request.
181 - *
182 - * @param {object} req
183 - * @api private
184 - */
185 -
186 -function getCharset (req) {
187 - try {
188 - return (contentType.parse(req).parameters.charset || '').toLowerCase()
189 - } catch (e) {
190 - return undefined
191 - }
192 -}
193 -
194 -/**
195 - * Normalize a SyntaxError for JSON.parse.
196 - *
197 - * @param {SyntaxError} error
198 - * @param {object} obj
199 - * @return {SyntaxError}
200 - */
201 -
202 -function normalizeJsonSyntaxError (error, obj) {
203 - var keys = Object.getOwnPropertyNames(error)
204 -
205 - for (var i = 0; i < keys.length; i++) {
206 - var key = keys[i]
207 - if (key !== 'stack' && key !== 'message') {
208 - delete error[key]
209 - }
210 - }
211 -
212 - // replace stack before message for Node.js 0.10 and below
213 - error.stack = obj.stack.replace(error.message, obj.message)
214 - error.message = obj.message
215 -
216 - return error
217 -}
218 -
219 -/**
220 - * Get the simple type checker.
221 - *
222 - * @param {string} type
223 - * @return {function}
224 - */
225 -
226 -function typeChecker (type) {
227 - return function checkType (req) {
228 - return Boolean(typeis(req, type))
229 - }
230 -}
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
4 - * MIT Licensed
5 - */
6 -
7 -'use strict'
8 -
9 -/**
10 - * Module dependencies.
11 - */
12 -
13 -var bytes = require('bytes')
14 -var debug = require('debug')('body-parser:raw')
15 -var read = require('../read')
16 -var typeis = require('type-is')
17 -
18 -/**
19 - * Module exports.
20 - */
21 -
22 -module.exports = raw
23 -
24 -/**
25 - * Create a middleware to parse raw bodies.
26 - *
27 - * @param {object} [options]
28 - * @return {function}
29 - * @api public
30 - */
31 -
32 -function raw (options) {
33 - var opts = options || {}
34 -
35 - var inflate = opts.inflate !== false
36 - var limit = typeof opts.limit !== 'number'
37 - ? bytes.parse(opts.limit || '100kb')
38 - : opts.limit
39 - var type = opts.type || 'application/octet-stream'
40 - var verify = opts.verify || false
41 -
42 - if (verify !== false && typeof verify !== 'function') {
43 - throw new TypeError('option verify must be function')
44 - }
45 -
46 - // create the appropriate type checking function
47 - var shouldParse = typeof type !== 'function'
48 - ? typeChecker(type)
49 - : type
50 -
51 - function parse (buf) {
52 - return buf
53 - }
54 -
55 - return function rawParser (req, res, next) {
56 - if (req._body) {
57 - debug('body already parsed')
58 - next()
59 - return
60 - }
61 -
62 - req.body = req.body || {}
63 -
64 - // skip requests without bodies
65 - if (!typeis.hasBody(req)) {
66 - debug('skip empty body')
67 - next()
68 - return
69 - }
70 -
71 - debug('content-type %j', req.headers['content-type'])
72 -
73 - // determine if request should be parsed
74 - if (!shouldParse(req)) {
75 - debug('skip parsing')
76 - next()
77 - return
78 - }
79 -
80 - // read
81 - read(req, res, next, parse, debug, {
82 - encoding: null,
83 - inflate: inflate,
84 - limit: limit,
85 - verify: verify
86 - })
87 - }
88 -}
89 -
90 -/**
91 - * Get the simple type checker.
92 - *
93 - * @param {string} type
94 - * @return {function}
95 - */
96 -
97 -function typeChecker (type) {
98 - return function checkType (req) {
99 - return Boolean(typeis(req, type))
100 - }
101 -}
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
4 - * MIT Licensed
5 - */
6 -
7 -'use strict'
8 -
9 -/**
10 - * Module dependencies.
11 - */
12 -
13 -var bytes = require('bytes')
14 -var contentType = require('content-type')
15 -var debug = require('debug')('body-parser:text')
16 -var read = require('../read')
17 -var typeis = require('type-is')
18 -
19 -/**
20 - * Module exports.
21 - */
22 -
23 -module.exports = text
24 -
25 -/**
26 - * Create a middleware to parse text bodies.
27 - *
28 - * @param {object} [options]
29 - * @return {function}
30 - * @api public
31 - */
32 -
33 -function text (options) {
34 - var opts = options || {}
35 -
36 - var defaultCharset = opts.defaultCharset || 'utf-8'
37 - var inflate = opts.inflate !== false
38 - var limit = typeof opts.limit !== 'number'
39 - ? bytes.parse(opts.limit || '100kb')
40 - : opts.limit
41 - var type = opts.type || 'text/plain'
42 - var verify = opts.verify || false
43 -
44 - if (verify !== false && typeof verify !== 'function') {
45 - throw new TypeError('option verify must be function')
46 - }
47 -
48 - // create the appropriate type checking function
49 - var shouldParse = typeof type !== 'function'
50 - ? typeChecker(type)
51 - : type
52 -
53 - function parse (buf) {
54 - return buf
55 - }
56 -
57 - return function textParser (req, res, next) {
58 - if (req._body) {
59 - debug('body already parsed')
60 - next()
61 - return
62 - }
63 -
64 - req.body = req.body || {}
65 -
66 - // skip requests without bodies
67 - if (!typeis.hasBody(req)) {
68 - debug('skip empty body')
69 - next()
70 - return
71 - }
72 -
73 - debug('content-type %j', req.headers['content-type'])
74 -
75 - // determine if request should be parsed
76 - if (!shouldParse(req)) {
77 - debug('skip parsing')
78 - next()
79 - return
80 - }
81 -
82 - // get charset
83 - var charset = getCharset(req) || defaultCharset
84 -
85 - // read
86 - read(req, res, next, parse, debug, {
87 - encoding: charset,
88 - inflate: inflate,
89 - limit: limit,
90 - verify: verify
91 - })
92 - }
93 -}
94 -
95 -/**
96 - * Get the charset of a request.
97 - *
98 - * @param {object} req
99 - * @api private
100 - */
101 -
102 -function getCharset (req) {
103 - try {
104 - return (contentType.parse(req).parameters.charset || '').toLowerCase()
105 - } catch (e) {
106 - return undefined
107 - }
108 -}
109 -
110 -/**
111 - * Get the simple type checker.
112 - *
113 - * @param {string} type
114 - * @return {function}
115 - */
116 -
117 -function typeChecker (type) {
118 - return function checkType (req) {
119 - return Boolean(typeis(req, type))
120 - }
121 -}
1 -/*!
2 - * body-parser
3 - * Copyright(c) 2014 Jonathan Ong
4 - * Copyright(c) 2014-2015 Douglas Christopher Wilson
5 - * MIT Licensed
6 - */
7 -
8 -'use strict'
9 -
10 -/**
11 - * Module dependencies.
12 - * @private
13 - */
14 -
15 -var bytes = require('bytes')
16 -var contentType = require('content-type')
17 -var createError = require('http-errors')
18 -var debug = require('debug')('body-parser:urlencoded')
19 -var deprecate = require('depd')('body-parser')
20 -var read = require('../read')
21 -var typeis = require('type-is')
22 -
23 -/**
24 - * Module exports.
25 - */
26 -
27 -module.exports = urlencoded
28 -
29 -/**
30 - * Cache of parser modules.
31 - */
32 -
33 -var parsers = Object.create(null)
34 -
35 -/**
36 - * Create a middleware to parse urlencoded bodies.
37 - *
38 - * @param {object} [options]
39 - * @return {function}
40 - * @public
41 - */
42 -
43 -function urlencoded (options) {
44 - var opts = options || {}
45 -
46 - // notice because option default will flip in next major
47 - if (opts.extended === undefined) {
48 - deprecate('undefined extended: provide extended option')
49 - }
50 -
51 - var extended = opts.extended !== false
52 - var inflate = opts.inflate !== false
53 - var limit = typeof opts.limit !== 'number'
54 - ? bytes.parse(opts.limit || '100kb')
55 - : opts.limit
56 - var type = opts.type || 'application/x-www-form-urlencoded'
57 - var verify = opts.verify || false
58 -
59 - if (verify !== false && typeof verify !== 'function') {
60 - throw new TypeError('option verify must be function')
61 - }
62 -
63 - // create the appropriate query parser
64 - var queryparse = extended
65 - ? extendedparser(opts)
66 - : simpleparser(opts)
67 -
68 - // create the appropriate type checking function
69 - var shouldParse = typeof type !== 'function'
70 - ? typeChecker(type)
71 - : type
72 -
73 - function parse (body) {
74 - return body.length
75 - ? queryparse(body)
76 - : {}
77 - }
78 -
79 - return function urlencodedParser (req, res, next) {
80 - if (req._body) {
81 - debug('body already parsed')
82 - next()
83 - return
84 - }
85 -
86 - req.body = req.body || {}
87 -
88 - // skip requests without bodies
89 - if (!typeis.hasBody(req)) {
90 - debug('skip empty body')
91 - next()
92 - return
93 - }
94 -
95 - debug('content-type %j', req.headers['content-type'])
96 -
97 - // determine if request should be parsed
98 - if (!shouldParse(req)) {
99 - debug('skip parsing')
100 - next()
101 - return
102 - }
103 -
104 - // assert charset
105 - var charset = getCharset(req) || 'utf-8'
106 - if (charset !== 'utf-8') {
107 - debug('invalid charset')
108 - next(createError(415, 'unsupported charset "' + charset.toUpperCase() + '"', {
109 - charset: charset,
110 - type: 'charset.unsupported'
111 - }))
112 - return
113 - }
114 -
115 - // read
116 - read(req, res, next, parse, debug, {
117 - debug: debug,
118 - encoding: charset,
119 - inflate: inflate,
120 - limit: limit,
121 - verify: verify
122 - })
123 - }
124 -}
125 -
126 -/**
127 - * Get the extended query parser.
128 - *
129 - * @param {object} options
130 - */
131 -
132 -function extendedparser (options) {
133 - var parameterLimit = options.parameterLimit !== undefined
134 - ? options.parameterLimit
135 - : 1000
136 - var parse = parser('qs')
137 -
138 - if (isNaN(parameterLimit) || parameterLimit < 1) {
139 - throw new TypeError('option parameterLimit must be a positive number')
140 - }
141 -
142 - if (isFinite(parameterLimit)) {
143 - parameterLimit = parameterLimit | 0
144 - }
145 -
146 - return function queryparse (body) {
147 - var paramCount = parameterCount(body, parameterLimit)
148 -
149 - if (paramCount === undefined) {
150 - debug('too many parameters')
151 - throw createError(413, 'too many parameters', {
152 - type: 'parameters.too.many'
153 - })
154 - }
155 -
156 - var arrayLimit = Math.max(100, paramCount)
157 -
158 - debug('parse extended urlencoding')
159 - return parse(body, {
160 - allowPrototypes: true,
161 - arrayLimit: arrayLimit,
162 - depth: Infinity,
163 - parameterLimit: parameterLimit
164 - })
165 - }
166 -}
167 -
168 -/**
169 - * Get the charset of a request.
170 - *
171 - * @param {object} req
172 - * @api private
173 - */
174 -
175 -function getCharset (req) {
176 - try {
177 - return (contentType.parse(req).parameters.charset || '').toLowerCase()
178 - } catch (e) {
179 - return undefined
180 - }
181 -}
182 -
183 -/**
184 - * Count the number of parameters, stopping once limit reached
185 - *
186 - * @param {string} body
187 - * @param {number} limit
188 - * @api private
189 - */
190 -
191 -function parameterCount (body, limit) {
192 - var count = 0
193 - var index = 0
194 -
195 - while ((index = body.indexOf('&', index)) !== -1) {
196 - count++
197 - index++
198 -
199 - if (count === limit) {
200 - return undefined
201 - }
202 - }
203 -
204 - return count
205 -}
206 -
207 -/**
208 - * Get parser for module name dynamically.
209 - *
210 - * @param {string} name
211 - * @return {function}
212 - * @api private
213 - */
214 -
215 -function parser (name) {
216 - var mod = parsers[name]
217 -
218 - if (mod !== undefined) {
219 - return mod.parse
220 - }
221 -
222 - // this uses a switch for static require analysis
223 - switch (name) {
224 - case 'qs':
225 - mod = require('qs')
226 - break
227 - case 'querystring':
228 - mod = require('querystring')
229 - break
230 - }
231 -
232 - // store to prevent invoking require()
233 - parsers[name] = mod
234 -
235 - return mod.parse
236 -}
237 -
238 -/**
239 - * Get the simple query parser.
240 - *
241 - * @param {object} options
242 - */
243 -
244 -function simpleparser (options) {
245 - var parameterLimit = options.parameterLimit !== undefined
246 - ? options.parameterLimit
247 - : 1000
248 - var parse = parser('querystring')
249 -
250 - if (isNaN(parameterLimit) || parameterLimit < 1) {
251 - throw new TypeError('option parameterLimit must be a positive number')
252 - }
253 -
254 - if (isFinite(parameterLimit)) {
255 - parameterLimit = parameterLimit | 0
256 - }
257 -
258 - return function queryparse (body) {
259 - var paramCount = parameterCount(body, parameterLimit)
260 -
261 - if (paramCount === undefined) {
262 - debug('too many parameters')
263 - throw createError(413, 'too many parameters', {
264 - type: 'parameters.too.many'
265 - })
266 - }
267 -
268 - debug('parse urlencoding')
269 - return parse(body, undefined, undefined, { maxKeys: parameterLimit })
270 - }
271 -}
272 -
273 -/**
274 - * Get the simple type checker.
275 - *
276 - * @param {string} type
277 - * @return {function}
278 - */
279 -
280 -function typeChecker (type) {
281 - return function checkType (req) {
282 - return Boolean(typeis(req, type))
283 - }
284 -}
1 -{
2 - "_from": "body-parser",
3 - "_id": "body-parser@1.19.0",
4 - "_inBundle": false,
5 - "_integrity": "sha512-dhEPs72UPbDnAQJ9ZKMNTP6ptJaionhP5cBb541nXPlW60Jepo9RV/a4fX4XWW9CuFNK22krhrj1+rgzifNCsw==",
6 - "_location": "/body-parser",
7 - "_phantomChildren": {},
8 - "_requested": {
9 - "type": "tag",
10 - "registry": true,
11 - "raw": "body-parser",
12 - "name": "body-parser",
13 - "escapedName": "body-parser",
14 - "rawSpec": "",
15 - "saveSpec": null,
16 - "fetchSpec": "latest"
17 - },
18 - "_requiredBy": [
19 - "#USER",
20 - "/",
21 - "/express"
22 - ],
23 - "_resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.19.0.tgz",
24 - "_shasum": "96b2709e57c9c4e09a6fd66a8fd979844f69f08a",
25 - "_spec": "body-parser",
26 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
27 - "bugs": {
28 - "url": "https://github.com/expressjs/body-parser/issues"
29 - },
30 - "bundleDependencies": false,
31 - "contributors": [
32 - {
33 - "name": "Douglas Christopher Wilson",
34 - "email": "doug@somethingdoug.com"
35 - },
36 - {
37 - "name": "Jonathan Ong",
38 - "email": "me@jongleberry.com",
39 - "url": "http://jongleberry.com"
40 - }
41 - ],
42 - "dependencies": {
43 - "bytes": "3.1.0",
44 - "content-type": "~1.0.4",
45 - "debug": "2.6.9",
46 - "depd": "~1.1.2",
47 - "http-errors": "1.7.2",
48 - "iconv-lite": "0.4.24",
49 - "on-finished": "~2.3.0",
50 - "qs": "6.7.0",
51 - "raw-body": "2.4.0",
52 - "type-is": "~1.6.17"
53 - },
54 - "deprecated": false,
55 - "description": "Node.js body parsing middleware",
56 - "devDependencies": {
57 - "eslint": "5.16.0",
58 - "eslint-config-standard": "12.0.0",
59 - "eslint-plugin-import": "2.17.2",
60 - "eslint-plugin-markdown": "1.0.0",
61 - "eslint-plugin-node": "8.0.1",
62 - "eslint-plugin-promise": "4.1.1",
63 - "eslint-plugin-standard": "4.0.0",
64 - "istanbul": "0.4.5",
65 - "methods": "1.1.2",
66 - "mocha": "6.1.4",
67 - "safe-buffer": "5.1.2",
68 - "supertest": "4.0.2"
69 - },
70 - "engines": {
71 - "node": ">= 0.8"
72 - },
73 - "files": [
74 - "lib/",
75 - "LICENSE",
76 - "HISTORY.md",
77 - "index.js"
78 - ],
79 - "homepage": "https://github.com/expressjs/body-parser#readme",
80 - "license": "MIT",
81 - "name": "body-parser",
82 - "repository": {
83 - "type": "git",
84 - "url": "git+https://github.com/expressjs/body-parser.git"
85 - },
86 - "scripts": {
87 - "lint": "eslint --plugin markdown --ext js,md .",
88 - "test": "mocha --require test/support/env --reporter spec --check-leaks --bail test/",
89 - "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --require test/support/env --reporter dot --check-leaks test/",
90 - "test-travis": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --require test/support/env --reporter spec --check-leaks test/"
91 - },
92 - "version": "1.19.0"
93 -}
1 -3.1.0 / 2019-01-22
2 -==================
3 -
4 - * Add petabyte (`pb`) support
5 -
6 -3.0.0 / 2017-08-31
7 -==================
8 -
9 - * Change "kB" to "KB" in format output
10 - * Remove support for Node.js 0.6
11 - * Remove support for ComponentJS
12 -
13 -2.5.0 / 2017-03-24
14 -==================
15 -
16 - * Add option "unit"
17 -
18 -2.4.0 / 2016-06-01
19 -==================
20 -
21 - * Add option "unitSeparator"
22 -
23 -2.3.0 / 2016-02-15
24 -==================
25 -
26 - * Drop partial bytes on all parsed units
27 - * Fix non-finite numbers to `.format` to return `null`
28 - * Fix parsing byte string that looks like hex
29 - * perf: hoist regular expressions
30 -
31 -2.2.0 / 2015-11-13
32 -==================
33 -
34 - * add option "decimalPlaces"
35 - * add option "fixedDecimals"
36 -
37 -2.1.0 / 2015-05-21
38 -==================
39 -
40 - * add `.format` export
41 - * add `.parse` export
42 -
43 -2.0.2 / 2015-05-20
44 -==================
45 -
46 - * remove map recreation
47 - * remove unnecessary object construction
48 -
49 -2.0.1 / 2015-05-07
50 -==================
51 -
52 - * fix browserify require
53 - * remove node.extend dependency
54 -
55 -2.0.0 / 2015-04-12
56 -==================
57 -
58 - * add option "case"
59 - * add option "thousandsSeparator"
60 - * return "null" on invalid parse input
61 - * support proper round-trip: bytes(bytes(num)) === num
62 - * units no longer case sensitive when parsing
63 -
64 -1.0.0 / 2014-05-05
65 -==================
66 -
67 - * add negative support. fixes #6
68 -
69 -0.3.0 / 2014-03-19
70 -==================
71 -
72 - * added terabyte support
73 -
74 -0.2.1 / 2013-04-01
75 -==================
76 -
77 - * add .component
78 -
79 -0.2.0 / 2012-10-28
80 -==================
81 -
82 - * bytes(200).should.eql('200b')
83 -
84 -0.1.0 / 2012-07-04
85 -==================
86 -
87 - * add bytes to string conversion [yields]
1 -(The MIT License)
2 -
3 -Copyright (c) 2012-2014 TJ Holowaychuk <tj@vision-media.ca>
4 -Copyright (c) 2015 Jed Watson <jed.watson@me.com>
5 -
6 -Permission is hereby granted, free of charge, to any person obtaining
7 -a copy of this software and associated documentation files (the
8 -'Software'), to deal in the Software without restriction, including
9 -without limitation the rights to use, copy, modify, merge, publish,
10 -distribute, sublicense, and/or sell copies of the Software, and to
11 -permit persons to whom the Software is furnished to do so, subject to
12 -the following conditions:
13 -
14 -The above copyright notice and this permission notice shall be
15 -included in all copies or substantial portions of the Software.
16 -
17 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
18 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
21 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1 -# Bytes utility
2 -
3 -[![NPM Version][npm-image]][npm-url]
4 -[![NPM Downloads][downloads-image]][downloads-url]
5 -[![Build Status][travis-image]][travis-url]
6 -[![Test Coverage][coveralls-image]][coveralls-url]
7 -
8 -Utility to parse a string bytes (ex: `1TB`) to bytes (`1099511627776`) and vice-versa.
9 -
10 -## Installation
11 -
12 -This is a [Node.js](https://nodejs.org/en/) module available through the
13 -[npm registry](https://www.npmjs.com/). Installation is done using the
14 -[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
15 -
16 -```bash
17 -$ npm install bytes
18 -```
19 -
20 -## Usage
21 -
22 -```js
23 -var bytes = require('bytes');
24 -```
25 -
26 -#### bytes.format(number value, [options]): string|null
27 -
28 -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
29 - rounded.
30 -
31 -**Arguments**
32 -
33 -| Name | Type | Description |
34 -|---------|----------|--------------------|
35 -| value | `number` | Value in bytes |
36 -| options | `Object` | Conversion options |
37 -
38 -**Options**
39 -
40 -| Property | Type | Description |
41 -|-------------------|--------|-----------------------------------------------------------------------------------------|
42 -| decimalPlaces | `number``null` | Maximum number of decimal places to include in output. Default value to `2`. |
43 -| fixedDecimals | `boolean``null` | Whether to always display the maximum number of decimal places. Default value to `false` |
44 -| thousandsSeparator | `string``null` | Example of values: `' '`, `','` and `.`... Default value to `''`. |
45 -| unit | `string``null` | The unit in which the result will be returned (B/KB/MB/GB/TB). Default value to `''` (which means auto detect). |
46 -| unitSeparator | `string``null` | Separator to use between number and unit. Default value to `''`. |
47 -
48 -**Returns**
49 -
50 -| Name | Type | Description |
51 -|---------|------------------|-------------------------------------------------|
52 -| results | `string``null` | Return null upon error. String value otherwise. |
53 -
54 -**Example**
55 -
56 -```js
57 -bytes(1024);
58 -// output: '1KB'
59 -
60 -bytes(1000);
61 -// output: '1000B'
62 -
63 -bytes(1000, {thousandsSeparator: ' '});
64 -// output: '1 000B'
65 -
66 -bytes(1024 * 1.7, {decimalPlaces: 0});
67 -// output: '2KB'
68 -
69 -bytes(1024, {unitSeparator: ' '});
70 -// output: '1 KB'
71 -
72 -```
73 -
74 -#### bytes.parse(string|number value): number|null
75 -
76 -Parse the string value into an integer in bytes. If no unit is given, or `value`
77 -is a number, it is assumed the value is in bytes.
78 -
79 -Supported units and abbreviations are as follows and are case-insensitive:
80 -
81 - * `b` for bytes
82 - * `kb` for kilobytes
83 - * `mb` for megabytes
84 - * `gb` for gigabytes
85 - * `tb` for terabytes
86 - * `pb` for petabytes
87 -
88 -The units are in powers of two, not ten. This means 1kb = 1024b according to this parser.
89 -
90 -**Arguments**
91 -
92 -| Name | Type | Description |
93 -|---------------|--------|--------------------|
94 -| value | `string``number` | String to parse, or number in bytes. |
95 -
96 -**Returns**
97 -
98 -| Name | Type | Description |
99 -|---------|-------------|-------------------------|
100 -| results | `number``null` | Return null upon error. Value in bytes otherwise. |
101 -
102 -**Example**
103 -
104 -```js
105 -bytes('1KB');
106 -// output: 1024
107 -
108 -bytes('1024');
109 -// output: 1024
110 -
111 -bytes(1024);
112 -// output: 1KB
113 -```
114 -
115 -## License
116 -
117 -[MIT](LICENSE)
118 -
119 -[coveralls-image]: https://badgen.net/coveralls/c/github/visionmedia/bytes.js/master
120 -[coveralls-url]: https://coveralls.io/r/visionmedia/bytes.js?branch=master
121 -[downloads-image]: https://badgen.net/npm/dm/bytes
122 -[downloads-url]: https://npmjs.org/package/bytes
123 -[npm-image]: https://badgen.net/npm/node/bytes
124 -[npm-url]: https://npmjs.org/package/bytes
125 -[travis-image]: https://badgen.net/travis/visionmedia/bytes.js/master
126 -[travis-url]: https://travis-ci.org/visionmedia/bytes.js
1 -/*!
2 - * bytes
3 - * Copyright(c) 2012-2014 TJ Holowaychuk
4 - * Copyright(c) 2015 Jed Watson
5 - * MIT Licensed
6 - */
7 -
8 -'use strict';
9 -
10 -/**
11 - * Module exports.
12 - * @public
13 - */
14 -
15 -module.exports = bytes;
16 -module.exports.format = format;
17 -module.exports.parse = parse;
18 -
19 -/**
20 - * Module variables.
21 - * @private
22 - */
23 -
24 -var formatThousandsRegExp = /\B(?=(\d{3})+(?!\d))/g;
25 -
26 -var formatDecimalsRegExp = /(?:\.0*|(\.[^0]+)0+)$/;
27 -
28 -var map = {
29 - b: 1,
30 - kb: 1 << 10,
31 - mb: 1 << 20,
32 - gb: 1 << 30,
33 - tb: Math.pow(1024, 4),
34 - pb: Math.pow(1024, 5),
35 -};
36 -
37 -var parseRegExp = /^((-|\+)?(\d+(?:\.\d+)?)) *(kb|mb|gb|tb|pb)$/i;
38 -
39 -/**
40 - * Convert the given value in bytes into a string or parse to string to an integer in bytes.
41 - *
42 - * @param {string|number} value
43 - * @param {{
44 - * case: [string],
45 - * decimalPlaces: [number]
46 - * fixedDecimals: [boolean]
47 - * thousandsSeparator: [string]
48 - * unitSeparator: [string]
49 - * }} [options] bytes options.
50 - *
51 - * @returns {string|number|null}
52 - */
53 -
54 -function bytes(value, options) {
55 - if (typeof value === 'string') {
56 - return parse(value);
57 - }
58 -
59 - if (typeof value === 'number') {
60 - return format(value, options);
61 - }
62 -
63 - return null;
64 -}
65 -
66 -/**
67 - * Format the given value in bytes into a string.
68 - *
69 - * If the value is negative, it is kept as such. If it is a float,
70 - * it is rounded.
71 - *
72 - * @param {number} value
73 - * @param {object} [options]
74 - * @param {number} [options.decimalPlaces=2]
75 - * @param {number} [options.fixedDecimals=false]
76 - * @param {string} [options.thousandsSeparator=]
77 - * @param {string} [options.unit=]
78 - * @param {string} [options.unitSeparator=]
79 - *
80 - * @returns {string|null}
81 - * @public
82 - */
83 -
84 -function format(value, options) {
85 - if (!Number.isFinite(value)) {
86 - return null;
87 - }
88 -
89 - var mag = Math.abs(value);
90 - var thousandsSeparator = (options && options.thousandsSeparator) || '';
91 - var unitSeparator = (options && options.unitSeparator) || '';
92 - var decimalPlaces = (options && options.decimalPlaces !== undefined) ? options.decimalPlaces : 2;
93 - var fixedDecimals = Boolean(options && options.fixedDecimals);
94 - var unit = (options && options.unit) || '';
95 -
96 - if (!unit || !map[unit.toLowerCase()]) {
97 - if (mag >= map.pb) {
98 - unit = 'PB';
99 - } else if (mag >= map.tb) {
100 - unit = 'TB';
101 - } else if (mag >= map.gb) {
102 - unit = 'GB';
103 - } else if (mag >= map.mb) {
104 - unit = 'MB';
105 - } else if (mag >= map.kb) {
106 - unit = 'KB';
107 - } else {
108 - unit = 'B';
109 - }
110 - }
111 -
112 - var val = value / map[unit.toLowerCase()];
113 - var str = val.toFixed(decimalPlaces);
114 -
115 - if (!fixedDecimals) {
116 - str = str.replace(formatDecimalsRegExp, '$1');
117 - }
118 -
119 - if (thousandsSeparator) {
120 - str = str.replace(formatThousandsRegExp, thousandsSeparator);
121 - }
122 -
123 - return str + unitSeparator + unit;
124 -}
125 -
126 -/**
127 - * Parse the string value into an integer in bytes.
128 - *
129 - * If no unit is given, it is assumed the value is in bytes.
130 - *
131 - * @param {number|string} val
132 - *
133 - * @returns {number|null}
134 - * @public
135 - */
136 -
137 -function parse(val) {
138 - if (typeof val === 'number' && !isNaN(val)) {
139 - return val;
140 - }
141 -
142 - if (typeof val !== 'string') {
143 - return null;
144 - }
145 -
146 - // Test if the string passed is valid
147 - var results = parseRegExp.exec(val);
148 - var floatValue;
149 - var unit = 'b';
150 -
151 - if (!results) {
152 - // Nothing could be extracted from the given string
153 - floatValue = parseInt(val, 10);
154 - unit = 'b'
155 - } else {
156 - // Retrieve the value and the unit
157 - floatValue = parseFloat(results[1]);
158 - unit = results[4].toLowerCase();
159 - }
160 -
161 - return Math.floor(map[unit] * floatValue);
162 -}
1 -{
2 - "_from": "bytes@3.1.0",
3 - "_id": "bytes@3.1.0",
4 - "_inBundle": false,
5 - "_integrity": "sha512-zauLjrfCG+xvoyaqLoV8bLVXXNGC4JqlxFCutSDWA6fJrTo2ZuvLYTqZ7aHBLZSMOopbzwv8f+wZcVzfVTI2Dg==",
6 - "_location": "/bytes",
7 - "_phantomChildren": {},
8 - "_requested": {
9 - "type": "version",
10 - "registry": true,
11 - "raw": "bytes@3.1.0",
12 - "name": "bytes",
13 - "escapedName": "bytes",
14 - "rawSpec": "3.1.0",
15 - "saveSpec": null,
16 - "fetchSpec": "3.1.0"
17 - },
18 - "_requiredBy": [
19 - "/body-parser",
20 - "/raw-body"
21 - ],
22 - "_resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.0.tgz",
23 - "_shasum": "f6cf7933a360e0588fa9fde85651cdc7f805d1f6",
24 - "_spec": "bytes@3.1.0",
25 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory\\node_modules\\body-parser",
26 - "author": {
27 - "name": "TJ Holowaychuk",
28 - "email": "tj@vision-media.ca",
29 - "url": "http://tjholowaychuk.com"
30 - },
31 - "bugs": {
32 - "url": "https://github.com/visionmedia/bytes.js/issues"
33 - },
34 - "bundleDependencies": false,
35 - "contributors": [
36 - {
37 - "name": "Jed Watson",
38 - "email": "jed.watson@me.com"
39 - },
40 - {
41 - "name": "Théo FIDRY",
42 - "email": "theo.fidry@gmail.com"
43 - }
44 - ],
45 - "deprecated": false,
46 - "description": "Utility to parse a string bytes to bytes and vice-versa",
47 - "devDependencies": {
48 - "eslint": "5.12.1",
49 - "mocha": "5.2.0",
50 - "nyc": "13.1.0"
51 - },
52 - "engines": {
53 - "node": ">= 0.8"
54 - },
55 - "files": [
56 - "History.md",
57 - "LICENSE",
58 - "Readme.md",
59 - "index.js"
60 - ],
61 - "homepage": "https://github.com/visionmedia/bytes.js#readme",
62 - "keywords": [
63 - "byte",
64 - "bytes",
65 - "utility",
66 - "parse",
67 - "parser",
68 - "convert",
69 - "converter"
70 - ],
71 - "license": "MIT",
72 - "name": "bytes",
73 - "repository": {
74 - "type": "git",
75 - "url": "git+https://github.com/visionmedia/bytes.js.git"
76 - },
77 - "scripts": {
78 - "lint": "eslint .",
79 - "test": "mocha --check-leaks --reporter spec",
80 - "test-ci": "nyc --reporter=text npm test",
81 - "test-cov": "nyc --reporter=html --reporter=text npm test"
82 - },
83 - "version": "3.1.0"
84 -}
1 -0.5.3 / 2018-12-17
2 -==================
3 -
4 - * Use `safe-buffer` for improved Buffer API
5 -
6 -0.5.2 / 2016-12-08
7 -==================
8 -
9 - * Fix `parse` to accept any linear whitespace character
10 -
11 -0.5.1 / 2016-01-17
12 -==================
13 -
14 - * perf: enable strict mode
15 -
16 -0.5.0 / 2014-10-11
17 -==================
18 -
19 - * Add `parse` function
20 -
21 -0.4.0 / 2014-09-21
22 -==================
23 -
24 - * Expand non-Unicode `filename` to the full ISO-8859-1 charset
25 -
26 -0.3.0 / 2014-09-20
27 -==================
28 -
29 - * Add `fallback` option
30 - * Add `type` option
31 -
32 -0.2.0 / 2014-09-19
33 -==================
34 -
35 - * Reduce ambiguity of file names with hex escape in buggy browsers
36 -
37 -0.1.2 / 2014-09-19
38 -==================
39 -
40 - * Fix periodic invalid Unicode filename header
41 -
42 -0.1.1 / 2014-09-19
43 -==================
44 -
45 - * Fix invalid characters appearing in `filename*` parameter
46 -
47 -0.1.0 / 2014-09-18
48 -==================
49 -
50 - * Make the `filename` argument optional
51 -
52 -0.0.0 / 2014-09-18
53 -==================
54 -
55 - * Initial release
1 -(The MIT License)
2 -
3 -Copyright (c) 2014-2017 Douglas Christopher Wilson
4 -
5 -Permission is hereby granted, free of charge, to any person obtaining
6 -a copy of this software and associated documentation files (the
7 -'Software'), to deal in the Software without restriction, including
8 -without limitation the rights to use, copy, modify, merge, publish,
9 -distribute, sublicense, and/or sell copies of the Software, and to
10 -permit persons to whom the Software is furnished to do so, subject to
11 -the following conditions:
12 -
13 -The above copyright notice and this permission notice shall be
14 -included in all copies or substantial portions of the Software.
15 -
16 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1 -# content-disposition
2 -
3 -[![NPM Version][npm-image]][npm-url]
4 -[![NPM Downloads][downloads-image]][downloads-url]
5 -[![Node.js Version][node-version-image]][node-version-url]
6 -[![Build Status][travis-image]][travis-url]
7 -[![Test Coverage][coveralls-image]][coveralls-url]
8 -
9 -Create and parse HTTP `Content-Disposition` header
10 -
11 -## Installation
12 -
13 -```sh
14 -$ npm install content-disposition
15 -```
16 -
17 -## API
18 -
19 -<!-- eslint-disable no-unused-vars -->
20 -
21 -```js
22 -var contentDisposition = require('content-disposition')
23 -```
24 -
25 -### contentDisposition(filename, options)
26 -
27 -Create an attachment `Content-Disposition` header value using the given file name,
28 -if supplied. The `filename` is optional and if no file name is desired, but you
29 -want to specify `options`, set `filename` to `undefined`.
30 -
31 -<!-- eslint-disable no-undef -->
32 -
33 -```js
34 -res.setHeader('Content-Disposition', contentDisposition('∫ maths.pdf'))
35 -```
36 -
37 -**note** HTTP headers are of the ISO-8859-1 character set. If you are writing this
38 -header through a means different from `setHeader` in Node.js, you'll want to specify
39 -the `'binary'` encoding in Node.js.
40 -
41 -#### Options
42 -
43 -`contentDisposition` accepts these properties in the options object.
44 -
45 -##### fallback
46 -
47 -If the `filename` option is outside ISO-8859-1, then the file name is actually
48 -stored in a supplemental field for clients that support Unicode file names and
49 -a ISO-8859-1 version of the file name is automatically generated.
50 -
51 -This specifies the ISO-8859-1 file name to override the automatic generation or
52 -disables the generation all together, defaults to `true`.
53 -
54 - - A string will specify the ISO-8859-1 file name to use in place of automatic
55 - generation.
56 - - `false` will disable including a ISO-8859-1 file name and only include the
57 - Unicode version (unless the file name is already ISO-8859-1).
58 - - `true` will enable automatic generation if the file name is outside ISO-8859-1.
59 -
60 -If the `filename` option is ISO-8859-1 and this option is specified and has a
61 -different value, then the `filename` option is encoded in the extended field
62 -and this set as the fallback field, even though they are both ISO-8859-1.
63 -
64 -##### type
65 -
66 -Specifies the disposition type, defaults to `"attachment"`. This can also be
67 -`"inline"`, or any other value (all values except inline are treated like
68 -`attachment`, but can convey additional information if both parties agree to
69 -it). The type is normalized to lower-case.
70 -
71 -### contentDisposition.parse(string)
72 -
73 -<!-- eslint-disable no-undef, no-unused-vars -->
74 -
75 -```js
76 -var disposition = contentDisposition.parse('attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt')
77 -```
78 -
79 -Parse a `Content-Disposition` header string. This automatically handles extended
80 -("Unicode") parameters by decoding them and providing them under the standard
81 -parameter name. This will return an object with the following properties (examples
82 -are shown for the string `'attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt'`):
83 -
84 - - `type`: The disposition type (always lower case). Example: `'attachment'`
85 -
86 - - `parameters`: An object of the parameters in the disposition (name of parameter
87 - always lower case and extended versions replace non-extended versions). Example:
88 - `{filename: "€ rates.txt"}`
89 -
90 -## Examples
91 -
92 -### Send a file for download
93 -
94 -```js
95 -var contentDisposition = require('content-disposition')
96 -var destroy = require('destroy')
97 -var fs = require('fs')
98 -var http = require('http')
99 -var onFinished = require('on-finished')
100 -
101 -var filePath = '/path/to/public/plans.pdf'
102 -
103 -http.createServer(function onRequest (req, res) {
104 - // set headers
105 - res.setHeader('Content-Type', 'application/pdf')
106 - res.setHeader('Content-Disposition', contentDisposition(filePath))
107 -
108 - // send file
109 - var stream = fs.createReadStream(filePath)
110 - stream.pipe(res)
111 - onFinished(res, function () {
112 - destroy(stream)
113 - })
114 -})
115 -```
116 -
117 -## Testing
118 -
119 -```sh
120 -$ npm test
121 -```
122 -
123 -## References
124 -
125 -- [RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1][rfc-2616]
126 -- [RFC 5987: Character Set and Language Encoding for Hypertext Transfer Protocol (HTTP) Header Field Parameters][rfc-5987]
127 -- [RFC 6266: Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP)][rfc-6266]
128 -- [Test Cases for HTTP Content-Disposition header field (RFC 6266) and the Encodings defined in RFCs 2047, 2231 and 5987][tc-2231]
129 -
130 -[rfc-2616]: https://tools.ietf.org/html/rfc2616
131 -[rfc-5987]: https://tools.ietf.org/html/rfc5987
132 -[rfc-6266]: https://tools.ietf.org/html/rfc6266
133 -[tc-2231]: http://greenbytes.de/tech/tc2231/
134 -
135 -## License
136 -
137 -[MIT](LICENSE)
138 -
139 -[npm-image]: https://img.shields.io/npm/v/content-disposition.svg
140 -[npm-url]: https://npmjs.org/package/content-disposition
141 -[node-version-image]: https://img.shields.io/node/v/content-disposition.svg
142 -[node-version-url]: https://nodejs.org/en/download
143 -[travis-image]: https://img.shields.io/travis/jshttp/content-disposition.svg
144 -[travis-url]: https://travis-ci.org/jshttp/content-disposition
145 -[coveralls-image]: https://img.shields.io/coveralls/jshttp/content-disposition.svg
146 -[coveralls-url]: https://coveralls.io/r/jshttp/content-disposition?branch=master
147 -[downloads-image]: https://img.shields.io/npm/dm/content-disposition.svg
148 -[downloads-url]: https://npmjs.org/package/content-disposition
This diff is collapsed. Click to expand it.
1 -{
2 - "_args": [
3 - [
4 - "content-disposition@0.5.3",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "content-disposition@0.5.3",
9 - "_id": "content-disposition@0.5.3",
10 - "_inBundle": false,
11 - "_integrity": "sha512-ExO0774ikEObIAEV9kDo50o+79VCUdEB6n6lzKgGwupcVeRlhrj3qGAfwq8G6uBJjkqLrhT0qEYFcWng8z1z0g==",
12 - "_location": "/content-disposition",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "content-disposition@0.5.3",
18 - "name": "content-disposition",
19 - "escapedName": "content-disposition",
20 - "rawSpec": "0.5.3",
21 - "saveSpec": null,
22 - "fetchSpec": "0.5.3"
23 - },
24 - "_requiredBy": [
25 - "/express"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.3.tgz",
28 - "_spec": "0.5.3",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "author": {
31 - "name": "Douglas Christopher Wilson",
32 - "email": "doug@somethingdoug.com"
33 - },
34 - "bugs": {
35 - "url": "https://github.com/jshttp/content-disposition/issues"
36 - },
37 - "dependencies": {
38 - "safe-buffer": "5.1.2"
39 - },
40 - "description": "Create and parse Content-Disposition header",
41 - "devDependencies": {
42 - "deep-equal": "1.0.1",
43 - "eslint": "5.10.0",
44 - "eslint-config-standard": "12.0.0",
45 - "eslint-plugin-import": "2.14.0",
46 - "eslint-plugin-markdown": "1.0.0-rc.1",
47 - "eslint-plugin-node": "7.0.1",
48 - "eslint-plugin-promise": "4.0.1",
49 - "eslint-plugin-standard": "4.0.0",
50 - "istanbul": "0.4.5",
51 - "mocha": "5.2.0"
52 - },
53 - "engines": {
54 - "node": ">= 0.6"
55 - },
56 - "files": [
57 - "LICENSE",
58 - "HISTORY.md",
59 - "README.md",
60 - "index.js"
61 - ],
62 - "homepage": "https://github.com/jshttp/content-disposition#readme",
63 - "keywords": [
64 - "content-disposition",
65 - "http",
66 - "rfc6266",
67 - "res"
68 - ],
69 - "license": "MIT",
70 - "name": "content-disposition",
71 - "repository": {
72 - "type": "git",
73 - "url": "git+https://github.com/jshttp/content-disposition.git"
74 - },
75 - "scripts": {
76 - "lint": "eslint --plugin markdown --ext js,md .",
77 - "test": "mocha --reporter spec --bail --check-leaks test/",
78 - "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --reporter dot --check-leaks test/",
79 - "test-travis": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --reporter spec --check-leaks test/"
80 - },
81 - "version": "0.5.3"
82 -}
1 -1.0.4 / 2017-09-11
2 -==================
3 -
4 - * perf: skip parameter parsing when no parameters
5 -
6 -1.0.3 / 2017-09-10
7 -==================
8 -
9 - * perf: remove argument reassignment
10 -
11 -1.0.2 / 2016-05-09
12 -==================
13 -
14 - * perf: enable strict mode
15 -
16 -1.0.1 / 2015-02-13
17 -==================
18 -
19 - * Improve missing `Content-Type` header error message
20 -
21 -1.0.0 / 2015-02-01
22 -==================
23 -
24 - * Initial implementation, derived from `media-typer@0.3.0`
1 -(The MIT License)
2 -
3 -Copyright (c) 2015 Douglas Christopher Wilson
4 -
5 -Permission is hereby granted, free of charge, to any person obtaining
6 -a copy of this software and associated documentation files (the
7 -'Software'), to deal in the Software without restriction, including
8 -without limitation the rights to use, copy, modify, merge, publish,
9 -distribute, sublicense, and/or sell copies of the Software, and to
10 -permit persons to whom the Software is furnished to do so, subject to
11 -the following conditions:
12 -
13 -The above copyright notice and this permission notice shall be
14 -included in all copies or substantial portions of the Software.
15 -
16 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1 -# content-type
2 -
3 -[![NPM Version][npm-image]][npm-url]
4 -[![NPM Downloads][downloads-image]][downloads-url]
5 -[![Node.js Version][node-version-image]][node-version-url]
6 -[![Build Status][travis-image]][travis-url]
7 -[![Test Coverage][coveralls-image]][coveralls-url]
8 -
9 -Create and parse HTTP Content-Type header according to RFC 7231
10 -
11 -## Installation
12 -
13 -```sh
14 -$ npm install content-type
15 -```
16 -
17 -## API
18 -
19 -```js
20 -var contentType = require('content-type')
21 -```
22 -
23 -### contentType.parse(string)
24 -
25 -```js
26 -var obj = contentType.parse('image/svg+xml; charset=utf-8')
27 -```
28 -
29 -Parse a content type string. This will return an object with the following
30 -properties (examples are shown for the string `'image/svg+xml; charset=utf-8'`):
31 -
32 - - `type`: The media type (the type and subtype, always lower case).
33 - Example: `'image/svg+xml'`
34 -
35 - - `parameters`: An object of the parameters in the media type (name of parameter
36 - always lower case). Example: `{charset: 'utf-8'}`
37 -
38 -Throws a `TypeError` if the string is missing or invalid.
39 -
40 -### contentType.parse(req)
41 -
42 -```js
43 -var obj = contentType.parse(req)
44 -```
45 -
46 -Parse the `content-type` header from the given `req`. Short-cut for
47 -`contentType.parse(req.headers['content-type'])`.
48 -
49 -Throws a `TypeError` if the `Content-Type` header is missing or invalid.
50 -
51 -### contentType.parse(res)
52 -
53 -```js
54 -var obj = contentType.parse(res)
55 -```
56 -
57 -Parse the `content-type` header set on the given `res`. Short-cut for
58 -`contentType.parse(res.getHeader('content-type'))`.
59 -
60 -Throws a `TypeError` if the `Content-Type` header is missing or invalid.
61 -
62 -### contentType.format(obj)
63 -
64 -```js
65 -var str = contentType.format({type: 'image/svg+xml'})
66 -```
67 -
68 -Format an object into a content type string. This will return a string of the
69 -content type for the given object with the following properties (examples are
70 -shown that produce the string `'image/svg+xml; charset=utf-8'`):
71 -
72 - - `type`: The media type (will be lower-cased). Example: `'image/svg+xml'`
73 -
74 - - `parameters`: An object of the parameters in the media type (name of the
75 - parameter will be lower-cased). Example: `{charset: 'utf-8'}`
76 -
77 -Throws a `TypeError` if the object contains an invalid type or parameter names.
78 -
79 -## License
80 -
81 -[MIT](LICENSE)
82 -
83 -[npm-image]: https://img.shields.io/npm/v/content-type.svg
84 -[npm-url]: https://npmjs.org/package/content-type
85 -[node-version-image]: https://img.shields.io/node/v/content-type.svg
86 -[node-version-url]: http://nodejs.org/download/
87 -[travis-image]: https://img.shields.io/travis/jshttp/content-type/master.svg
88 -[travis-url]: https://travis-ci.org/jshttp/content-type
89 -[coveralls-image]: https://img.shields.io/coveralls/jshttp/content-type/master.svg
90 -[coveralls-url]: https://coveralls.io/r/jshttp/content-type
91 -[downloads-image]: https://img.shields.io/npm/dm/content-type.svg
92 -[downloads-url]: https://npmjs.org/package/content-type
1 -/*!
2 - * content-type
3 - * Copyright(c) 2015 Douglas Christopher Wilson
4 - * MIT Licensed
5 - */
6 -
7 -'use strict'
8 -
9 -/**
10 - * RegExp to match *( ";" parameter ) in RFC 7231 sec 3.1.1.1
11 - *
12 - * parameter = token "=" ( token / quoted-string )
13 - * token = 1*tchar
14 - * tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*"
15 - * / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
16 - * / DIGIT / ALPHA
17 - * ; any VCHAR, except delimiters
18 - * quoted-string = DQUOTE *( qdtext / quoted-pair ) DQUOTE
19 - * qdtext = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text
20 - * obs-text = %x80-FF
21 - * quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text )
22 - */
23 -var PARAM_REGEXP = /; *([!#$%&'*+.^_`|~0-9A-Za-z-]+) *= *("(?:[\u000b\u0020\u0021\u0023-\u005b\u005d-\u007e\u0080-\u00ff]|\\[\u000b\u0020-\u00ff])*"|[!#$%&'*+.^_`|~0-9A-Za-z-]+) */g
24 -var TEXT_REGEXP = /^[\u000b\u0020-\u007e\u0080-\u00ff]+$/
25 -var TOKEN_REGEXP = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/
26 -
27 -/**
28 - * RegExp to match quoted-pair in RFC 7230 sec 3.2.6
29 - *
30 - * quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text )
31 - * obs-text = %x80-FF
32 - */
33 -var QESC_REGEXP = /\\([\u000b\u0020-\u00ff])/g
34 -
35 -/**
36 - * RegExp to match chars that must be quoted-pair in RFC 7230 sec 3.2.6
37 - */
38 -var QUOTE_REGEXP = /([\\"])/g
39 -
40 -/**
41 - * RegExp to match type in RFC 7231 sec 3.1.1.1
42 - *
43 - * media-type = type "/" subtype
44 - * type = token
45 - * subtype = token
46 - */
47 -var TYPE_REGEXP = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$/
48 -
49 -/**
50 - * Module exports.
51 - * @public
52 - */
53 -
54 -exports.format = format
55 -exports.parse = parse
56 -
57 -/**
58 - * Format object to media type.
59 - *
60 - * @param {object} obj
61 - * @return {string}
62 - * @public
63 - */
64 -
65 -function format (obj) {
66 - if (!obj || typeof obj !== 'object') {
67 - throw new TypeError('argument obj is required')
68 - }
69 -
70 - var parameters = obj.parameters
71 - var type = obj.type
72 -
73 - if (!type || !TYPE_REGEXP.test(type)) {
74 - throw new TypeError('invalid type')
75 - }
76 -
77 - var string = type
78 -
79 - // append parameters
80 - if (parameters && typeof parameters === 'object') {
81 - var param
82 - var params = Object.keys(parameters).sort()
83 -
84 - for (var i = 0; i < params.length; i++) {
85 - param = params[i]
86 -
87 - if (!TOKEN_REGEXP.test(param)) {
88 - throw new TypeError('invalid parameter name')
89 - }
90 -
91 - string += '; ' + param + '=' + qstring(parameters[param])
92 - }
93 - }
94 -
95 - return string
96 -}
97 -
98 -/**
99 - * Parse media type to object.
100 - *
101 - * @param {string|object} string
102 - * @return {Object}
103 - * @public
104 - */
105 -
106 -function parse (string) {
107 - if (!string) {
108 - throw new TypeError('argument string is required')
109 - }
110 -
111 - // support req/res-like objects as argument
112 - var header = typeof string === 'object'
113 - ? getcontenttype(string)
114 - : string
115 -
116 - if (typeof header !== 'string') {
117 - throw new TypeError('argument string is required to be a string')
118 - }
119 -
120 - var index = header.indexOf(';')
121 - var type = index !== -1
122 - ? header.substr(0, index).trim()
123 - : header.trim()
124 -
125 - if (!TYPE_REGEXP.test(type)) {
126 - throw new TypeError('invalid media type')
127 - }
128 -
129 - var obj = new ContentType(type.toLowerCase())
130 -
131 - // parse parameters
132 - if (index !== -1) {
133 - var key
134 - var match
135 - var value
136 -
137 - PARAM_REGEXP.lastIndex = index
138 -
139 - while ((match = PARAM_REGEXP.exec(header))) {
140 - if (match.index !== index) {
141 - throw new TypeError('invalid parameter format')
142 - }
143 -
144 - index += match[0].length
145 - key = match[1].toLowerCase()
146 - value = match[2]
147 -
148 - if (value[0] === '"') {
149 - // remove quotes and escapes
150 - value = value
151 - .substr(1, value.length - 2)
152 - .replace(QESC_REGEXP, '$1')
153 - }
154 -
155 - obj.parameters[key] = value
156 - }
157 -
158 - if (index !== header.length) {
159 - throw new TypeError('invalid parameter format')
160 - }
161 - }
162 -
163 - return obj
164 -}
165 -
166 -/**
167 - * Get content-type from req/res objects.
168 - *
169 - * @param {object}
170 - * @return {Object}
171 - * @private
172 - */
173 -
174 -function getcontenttype (obj) {
175 - var header
176 -
177 - if (typeof obj.getHeader === 'function') {
178 - // res-like
179 - header = obj.getHeader('content-type')
180 - } else if (typeof obj.headers === 'object') {
181 - // req-like
182 - header = obj.headers && obj.headers['content-type']
183 - }
184 -
185 - if (typeof header !== 'string') {
186 - throw new TypeError('content-type header is missing from object')
187 - }
188 -
189 - return header
190 -}
191 -
192 -/**
193 - * Quote a string if necessary.
194 - *
195 - * @param {string} val
196 - * @return {string}
197 - * @private
198 - */
199 -
200 -function qstring (val) {
201 - var str = String(val)
202 -
203 - // no need to quote tokens
204 - if (TOKEN_REGEXP.test(str)) {
205 - return str
206 - }
207 -
208 - if (str.length > 0 && !TEXT_REGEXP.test(str)) {
209 - throw new TypeError('invalid parameter value')
210 - }
211 -
212 - return '"' + str.replace(QUOTE_REGEXP, '\\$1') + '"'
213 -}
214 -
215 -/**
216 - * Class to represent a content type.
217 - * @private
218 - */
219 -function ContentType (type) {
220 - this.parameters = Object.create(null)
221 - this.type = type
222 -}
1 -{
2 - "_args": [
3 - [
4 - "content-type@1.0.4",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "content-type@1.0.4",
9 - "_id": "content-type@1.0.4",
10 - "_inBundle": false,
11 - "_integrity": "sha512-hIP3EEPs8tB9AT1L+NUqtwOAps4mk2Zob89MWXMHjHWg9milF/j4osnnQLXBCBFBk/tvIG/tUc9mOUJiPBhPXA==",
12 - "_location": "/content-type",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "content-type@1.0.4",
18 - "name": "content-type",
19 - "escapedName": "content-type",
20 - "rawSpec": "1.0.4",
21 - "saveSpec": null,
22 - "fetchSpec": "1.0.4"
23 - },
24 - "_requiredBy": [
25 - "/body-parser",
26 - "/express"
27 - ],
28 - "_resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.4.tgz",
29 - "_spec": "1.0.4",
30 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
31 - "author": {
32 - "name": "Douglas Christopher Wilson",
33 - "email": "doug@somethingdoug.com"
34 - },
35 - "bugs": {
36 - "url": "https://github.com/jshttp/content-type/issues"
37 - },
38 - "description": "Create and parse HTTP Content-Type header",
39 - "devDependencies": {
40 - "eslint": "3.19.0",
41 - "eslint-config-standard": "10.2.1",
42 - "eslint-plugin-import": "2.7.0",
43 - "eslint-plugin-node": "5.1.1",
44 - "eslint-plugin-promise": "3.5.0",
45 - "eslint-plugin-standard": "3.0.1",
46 - "istanbul": "0.4.5",
47 - "mocha": "~1.21.5"
48 - },
49 - "engines": {
50 - "node": ">= 0.6"
51 - },
52 - "files": [
53 - "LICENSE",
54 - "HISTORY.md",
55 - "README.md",
56 - "index.js"
57 - ],
58 - "homepage": "https://github.com/jshttp/content-type#readme",
59 - "keywords": [
60 - "content-type",
61 - "http",
62 - "req",
63 - "res",
64 - "rfc7231"
65 - ],
66 - "license": "MIT",
67 - "name": "content-type",
68 - "repository": {
69 - "type": "git",
70 - "url": "git+https://github.com/jshttp/content-type.git"
71 - },
72 - "scripts": {
73 - "lint": "eslint .",
74 - "test": "mocha --reporter spec --check-leaks --bail test/",
75 - "test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --reporter spec --check-leaks test/",
76 - "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --reporter dot --check-leaks test/"
77 - },
78 - "version": "1.0.4"
79 -}
1 -1.0.6 / 2015-02-03
2 -==================
3 -
4 -* use `npm test` instead of `make test` to run tests
5 -* clearer assertion messages when checking input
6 -
7 -
8 -1.0.5 / 2014-09-05
9 -==================
10 -
11 -* add license to package.json
12 -
13 -1.0.4 / 2014-06-25
14 -==================
15 -
16 - * corrected avoidance of timing attacks (thanks @tenbits!)
17 -
18 -1.0.3 / 2014-01-28
19 -==================
20 -
21 - * [incorrect] fix for timing attacks
22 -
23 -1.0.2 / 2014-01-28
24 -==================
25 -
26 - * fix missing repository warning
27 - * fix typo in test
28 -
29 -1.0.1 / 2013-04-15
30 -==================
31 -
32 - * Revert "Changed underlying HMAC algo. to sha512."
33 - * Revert "Fix for timing attacks on MAC verification."
34 -
35 -0.0.1 / 2010-01-03
36 -==================
37 -
38 - * Initial release
1 -
2 -# cookie-signature
3 -
4 - Sign and unsign cookies.
5 -
6 -## Example
7 -
8 -```js
9 -var cookie = require('cookie-signature');
10 -
11 -var val = cookie.sign('hello', 'tobiiscool');
12 -val.should.equal('hello.DGDUkGlIkCzPz+C0B064FNgHdEjox7ch8tOBGslZ5QI');
13 -
14 -var val = cookie.sign('hello', 'tobiiscool');
15 -cookie.unsign(val, 'tobiiscool').should.equal('hello');
16 -cookie.unsign(val, 'luna').should.be.false;
17 -```
18 -
19 -## License
20 -
21 -(The MIT License)
22 -
23 -Copyright (c) 2012 LearnBoost &lt;tj@learnboost.com&gt;
24 -
25 -Permission is hereby granted, free of charge, to any person obtaining
26 -a copy of this software and associated documentation files (the
27 -'Software'), to deal in the Software without restriction, including
28 -without limitation the rights to use, copy, modify, merge, publish,
29 -distribute, sublicense, and/or sell copies of the Software, and to
30 -permit persons to whom the Software is furnished to do so, subject to
31 -the following conditions:
32 -
33 -The above copyright notice and this permission notice shall be
34 -included in all copies or substantial portions of the Software.
35 -
36 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
37 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
38 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
39 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
40 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
41 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
42 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
...\ No newline at end of file ...\ No newline at end of file
1 -/**
2 - * Module dependencies.
3 - */
4 -
5 -var crypto = require('crypto');
6 -
7 -/**
8 - * Sign the given `val` with `secret`.
9 - *
10 - * @param {String} val
11 - * @param {String} secret
12 - * @return {String}
13 - * @api private
14 - */
15 -
16 -exports.sign = function(val, secret){
17 - if ('string' != typeof val) throw new TypeError("Cookie value must be provided as a string.");
18 - if ('string' != typeof secret) throw new TypeError("Secret string must be provided.");
19 - return val + '.' + crypto
20 - .createHmac('sha256', secret)
21 - .update(val)
22 - .digest('base64')
23 - .replace(/\=+$/, '');
24 -};
25 -
26 -/**
27 - * Unsign and decode the given `val` with `secret`,
28 - * returning `false` if the signature is invalid.
29 - *
30 - * @param {String} val
31 - * @param {String} secret
32 - * @return {String|Boolean}
33 - * @api private
34 - */
35 -
36 -exports.unsign = function(val, secret){
37 - if ('string' != typeof val) throw new TypeError("Signed cookie string must be provided.");
38 - if ('string' != typeof secret) throw new TypeError("Secret string must be provided.");
39 - var str = val.slice(0, val.lastIndexOf('.'))
40 - , mac = exports.sign(str, secret);
41 -
42 - return sha1(mac) == sha1(val) ? str : false;
43 -};
44 -
45 -/**
46 - * Private
47 - */
48 -
49 -function sha1(str){
50 - return crypto.createHash('sha1').update(str).digest('hex');
51 -}
1 -{
2 - "_args": [
3 - [
4 - "cookie-signature@1.0.6",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "cookie-signature@1.0.6",
9 - "_id": "cookie-signature@1.0.6",
10 - "_inBundle": false,
11 - "_integrity": "sha1-4wOogrNCzD7oylE6eZmXNNqzriw=",
12 - "_location": "/cookie-signature",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "cookie-signature@1.0.6",
18 - "name": "cookie-signature",
19 - "escapedName": "cookie-signature",
20 - "rawSpec": "1.0.6",
21 - "saveSpec": null,
22 - "fetchSpec": "1.0.6"
23 - },
24 - "_requiredBy": [
25 - "/express"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz",
28 - "_spec": "1.0.6",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "author": {
31 - "name": "TJ Holowaychuk",
32 - "email": "tj@learnboost.com"
33 - },
34 - "bugs": {
35 - "url": "https://github.com/visionmedia/node-cookie-signature/issues"
36 - },
37 - "dependencies": {},
38 - "description": "Sign and unsign cookies",
39 - "devDependencies": {
40 - "mocha": "*",
41 - "should": "*"
42 - },
43 - "homepage": "https://github.com/visionmedia/node-cookie-signature#readme",
44 - "keywords": [
45 - "cookie",
46 - "sign",
47 - "unsign"
48 - ],
49 - "license": "MIT",
50 - "main": "index",
51 - "name": "cookie-signature",
52 - "repository": {
53 - "type": "git",
54 - "url": "git+https://github.com/visionmedia/node-cookie-signature.git"
55 - },
56 - "scripts": {
57 - "test": "mocha --require should --reporter spec"
58 - },
59 - "version": "1.0.6"
60 -}
1 -0.4.0 / 2019-05-15
2 -==================
3 -
4 - * Add `SameSite=None` support
5 -
6 -0.3.1 / 2016-05-26
7 -==================
8 -
9 - * Fix `sameSite: true` to work with draft-7 clients
10 - - `true` now sends `SameSite=Strict` instead of `SameSite`
11 -
12 -0.3.0 / 2016-05-26
13 -==================
14 -
15 - * Add `sameSite` option
16 - - Replaces `firstPartyOnly` option, never implemented by browsers
17 - * Improve error message when `encode` is not a function
18 - * Improve error message when `expires` is not a `Date`
19 -
20 -0.2.4 / 2016-05-20
21 -==================
22 -
23 - * perf: enable strict mode
24 - * perf: use for loop in parse
25 - * perf: use string concatination for serialization
26 -
27 -0.2.3 / 2015-10-25
28 -==================
29 -
30 - * Fix cookie `Max-Age` to never be a floating point number
31 -
32 -0.2.2 / 2015-09-17
33 -==================
34 -
35 - * Fix regression when setting empty cookie value
36 - - Ease the new restriction, which is just basic header-level validation
37 - * Fix typo in invalid value errors
38 -
39 -0.2.1 / 2015-09-17
40 -==================
41 -
42 - * Throw on invalid values provided to `serialize`
43 - - Ensures the resulting string is a valid HTTP header value
44 -
45 -0.2.0 / 2015-08-13
46 -==================
47 -
48 - * Add `firstPartyOnly` option
49 - * Throw better error for invalid argument to parse
50 - * perf: hoist regular expression
51 -
52 -0.1.5 / 2015-09-17
53 -==================
54 -
55 - * Fix regression when setting empty cookie value
56 - - Ease the new restriction, which is just basic header-level validation
57 - * Fix typo in invalid value errors
58 -
59 -0.1.4 / 2015-09-17
60 -==================
61 -
62 - * Throw better error for invalid argument to parse
63 - * Throw on invalid values provided to `serialize`
64 - - Ensures the resulting string is a valid HTTP header value
65 -
66 -0.1.3 / 2015-05-19
67 -==================
68 -
69 - * Reduce the scope of try-catch deopt
70 - * Remove argument reassignments
71 -
72 -0.1.2 / 2014-04-16
73 -==================
74 -
75 - * Remove unnecessary files from npm package
76 -
77 -0.1.1 / 2014-02-23
78 -==================
79 -
80 - * Fix bad parse when cookie value contained a comma
81 - * Fix support for `maxAge` of `0`
82 -
83 -0.1.0 / 2013-05-01
84 -==================
85 -
86 - * Add `decode` option
87 - * Add `encode` option
88 -
89 -0.0.6 / 2013-04-08
90 -==================
91 -
92 - * Ignore cookie parts missing `=`
93 -
94 -0.0.5 / 2012-10-29
95 -==================
96 -
97 - * Return raw cookie value if value unescape errors
98 -
99 -0.0.4 / 2012-06-21
100 -==================
101 -
102 - * Use encode/decodeURIComponent for cookie encoding/decoding
103 - - Improve server/client interoperability
104 -
105 -0.0.3 / 2012-06-06
106 -==================
107 -
108 - * Only escape special characters per the cookie RFC
109 -
110 -0.0.2 / 2012-06-01
111 -==================
112 -
113 - * Fix `maxAge` option to not throw error
114 -
115 -0.0.1 / 2012-05-28
116 -==================
117 -
118 - * Add more tests
119 -
120 -0.0.0 / 2012-05-28
121 -==================
122 -
123 - * Initial release
1 -(The MIT License)
2 -
3 -Copyright (c) 2012-2014 Roman Shtylman <shtylman@gmail.com>
4 -Copyright (c) 2015 Douglas Christopher Wilson <doug@somethingdoug.com>
5 -
6 -Permission is hereby granted, free of charge, to any person obtaining
7 -a copy of this software and associated documentation files (the
8 -'Software'), to deal in the Software without restriction, including
9 -without limitation the rights to use, copy, modify, merge, publish,
10 -distribute, sublicense, and/or sell copies of the Software, and to
11 -permit persons to whom the Software is furnished to do so, subject to
12 -the following conditions:
13 -
14 -The above copyright notice and this permission notice shall be
15 -included in all copies or substantial portions of the Software.
16 -
17 -THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
18 -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20 -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
21 -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 -
1 -# cookie
2 -
3 -[![NPM Version][npm-version-image]][npm-url]
4 -[![NPM Downloads][npm-downloads-image]][npm-url]
5 -[![Node.js Version][node-version-image]][node-version-url]
6 -[![Build Status][travis-image]][travis-url]
7 -[![Test Coverage][coveralls-image]][coveralls-url]
8 -
9 -Basic HTTP cookie parser and serializer for HTTP servers.
10 -
11 -## Installation
12 -
13 -```sh
14 -$ npm install cookie
15 -```
16 -
17 -## API
18 -
19 -```js
20 -var cookie = require('cookie');
21 -```
22 -
23 -### cookie.parse(str, options)
24 -
25 -Parse an HTTP `Cookie` header string and returning an object of all cookie name-value pairs.
26 -The `str` argument is the string representing a `Cookie` header value and `options` is an
27 -optional object containing additional parsing options.
28 -
29 -```js
30 -var cookies = cookie.parse('foo=bar; equation=E%3Dmc%5E2');
31 -// { foo: 'bar', equation: 'E=mc^2' }
32 -```
33 -
34 -#### Options
35 -
36 -`cookie.parse` accepts these properties in the options object.
37 -
38 -##### decode
39 -
40 -Specifies a function that will be used to decode a cookie's value. Since the value of a cookie
41 -has a limited character set (and must be a simple string), this function can be used to decode
42 -a previously-encoded cookie value into a JavaScript string or other object.
43 -
44 -The default function is the global `decodeURIComponent`, which will decode any URL-encoded
45 -sequences into their byte representations.
46 -
47 -**note** if an error is thrown from this function, the original, non-decoded cookie value will
48 -be returned as the cookie's value.
49 -
50 -### cookie.serialize(name, value, options)
51 -
52 -Serialize a cookie name-value pair into a `Set-Cookie` header string. The `name` argument is the
53 -name for the cookie, the `value` argument is the value to set the cookie to, and the `options`
54 -argument is an optional object containing additional serialization options.
55 -
56 -```js
57 -var setCookie = cookie.serialize('foo', 'bar');
58 -// foo=bar
59 -```
60 -
61 -#### Options
62 -
63 -`cookie.serialize` accepts these properties in the options object.
64 -
65 -##### domain
66 -
67 -Specifies the value for the [`Domain` `Set-Cookie` attribute][rfc-6265-5.2.3]. By default, no
68 -domain is set, and most clients will consider the cookie to apply to only the current domain.
69 -
70 -##### encode
71 -
72 -Specifies a function that will be used to encode a cookie's value. Since value of a cookie
73 -has a limited character set (and must be a simple string), this function can be used to encode
74 -a value into a string suited for a cookie's value.
75 -
76 -The default function is the global `encodeURIComponent`, which will encode a JavaScript string
77 -into UTF-8 byte sequences and then URL-encode any that fall outside of the cookie range.
78 -
79 -##### expires
80 -
81 -Specifies the `Date` object to be the value for the [`Expires` `Set-Cookie` attribute][rfc-6265-5.2.1].
82 -By default, no expiration is set, and most clients will consider this a "non-persistent cookie" and
83 -will delete it on a condition like exiting a web browser application.
84 -
85 -**note** the [cookie storage model specification][rfc-6265-5.3] states that if both `expires` and
86 -`maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this,
87 -so if both are set, they should point to the same date and time.
88 -
89 -##### httpOnly
90 -
91 -Specifies the `boolean` value for the [`HttpOnly` `Set-Cookie` attribute][rfc-6265-5.2.6]. When truthy,
92 -the `HttpOnly` attribute is set, otherwise it is not. By default, the `HttpOnly` attribute is not set.
93 -
94 -**note** be careful when setting this to `true`, as compliant clients will not allow client-side
95 -JavaScript to see the cookie in `document.cookie`.
96 -
97 -##### maxAge
98 -
99 -Specifies the `number` (in seconds) to be the value for the [`Max-Age` `Set-Cookie` attribute][rfc-6265-5.2.2].
100 -The given number will be converted to an integer by rounding down. By default, no maximum age is set.
101 -
102 -**note** the [cookie storage model specification][rfc-6265-5.3] states that if both `expires` and
103 -`maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this,
104 -so if both are set, they should point to the same date and time.
105 -
106 -##### path
107 -
108 -Specifies the value for the [`Path` `Set-Cookie` attribute][rfc-6265-5.2.4]. By default, the path
109 -is considered the ["default path"][rfc-6265-5.1.4].
110 -
111 -##### sameSite
112 -
113 -Specifies the `boolean` or `string` to be the value for the [`SameSite` `Set-Cookie` attribute][rfc-6265bis-03-4.1.2.7].
114 -
115 - - `true` will set the `SameSite` attribute to `Strict` for strict same site enforcement.
116 - - `false` will not set the `SameSite` attribute.
117 - - `'lax'` will set the `SameSite` attribute to `Lax` for lax same site enforcement.
118 - - `'none'` will set the `SameSite` attribute to `None` for an explicit cross-site cookie.
119 - - `'strict'` will set the `SameSite` attribute to `Strict` for strict same site enforcement.
120 -
121 -More information about the different enforcement levels can be found in
122 -[the specification][rfc-6265bis-03-4.1.2.7].
123 -
124 -**note** This is an attribute that has not yet been fully standardized, and may change in the future.
125 -This also means many clients may ignore this attribute until they understand it.
126 -
127 -##### secure
128 -
129 -Specifies the `boolean` value for the [`Secure` `Set-Cookie` attribute][rfc-6265-5.2.5]. When truthy,
130 -the `Secure` attribute is set, otherwise it is not. By default, the `Secure` attribute is not set.
131 -
132 -**note** be careful when setting this to `true`, as compliant clients will not send the cookie back to
133 -the server in the future if the browser does not have an HTTPS connection.
134 -
135 -## Example
136 -
137 -The following example uses this module in conjunction with the Node.js core HTTP server
138 -to prompt a user for their name and display it back on future visits.
139 -
140 -```js
141 -var cookie = require('cookie');
142 -var escapeHtml = require('escape-html');
143 -var http = require('http');
144 -var url = require('url');
145 -
146 -function onRequest(req, res) {
147 - // Parse the query string
148 - var query = url.parse(req.url, true, true).query;
149 -
150 - if (query && query.name) {
151 - // Set a new cookie with the name
152 - res.setHeader('Set-Cookie', cookie.serialize('name', String(query.name), {
153 - httpOnly: true,
154 - maxAge: 60 * 60 * 24 * 7 // 1 week
155 - }));
156 -
157 - // Redirect back after setting cookie
158 - res.statusCode = 302;
159 - res.setHeader('Location', req.headers.referer || '/');
160 - res.end();
161 - return;
162 - }
163 -
164 - // Parse the cookies on the request
165 - var cookies = cookie.parse(req.headers.cookie || '');
166 -
167 - // Get the visitor name set in the cookie
168 - var name = cookies.name;
169 -
170 - res.setHeader('Content-Type', 'text/html; charset=UTF-8');
171 -
172 - if (name) {
173 - res.write('<p>Welcome back, <b>' + escapeHtml(name) + '</b>!</p>');
174 - } else {
175 - res.write('<p>Hello, new visitor!</p>');
176 - }
177 -
178 - res.write('<form method="GET">');
179 - res.write('<input placeholder="enter your name" name="name"> <input type="submit" value="Set Name">');
180 - res.end('</form>');
181 -}
182 -
183 -http.createServer(onRequest).listen(3000);
184 -```
185 -
186 -## Testing
187 -
188 -```sh
189 -$ npm test
190 -```
191 -
192 -## Benchmark
193 -
194 -```
195 -$ npm run bench
196 -
197 -> cookie@0.3.1 bench cookie
198 -> node benchmark/index.js
199 -
200 - http_parser@2.8.0
201 - node@6.14.2
202 - v8@5.1.281.111
203 - uv@1.16.1
204 - zlib@1.2.11
205 - ares@1.10.1-DEV
206 - icu@58.2
207 - modules@48
208 - napi@3
209 - openssl@1.0.2o
210 -
211 -> node benchmark/parse.js
212 -
213 - cookie.parse
214 -
215 - 6 tests completed.
216 -
217 - simple x 1,200,691 ops/sec ±1.12% (189 runs sampled)
218 - decode x 1,012,994 ops/sec ±0.97% (186 runs sampled)
219 - unquote x 1,074,174 ops/sec ±2.43% (186 runs sampled)
220 - duplicates x 438,424 ops/sec ±2.17% (184 runs sampled)
221 - 10 cookies x 147,154 ops/sec ±1.01% (186 runs sampled)
222 - 100 cookies x 14,274 ops/sec ±1.07% (187 runs sampled)
223 -```
224 -
225 -## References
226 -
227 -- [RFC 6265: HTTP State Management Mechanism][rfc-6265]
228 -- [Same-site Cookies][rfc-6265bis-03-4.1.2.7]
229 -
230 -[rfc-6265bis-03-4.1.2.7]: https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7
231 -[rfc-6265]: https://tools.ietf.org/html/rfc6265
232 -[rfc-6265-5.1.4]: https://tools.ietf.org/html/rfc6265#section-5.1.4
233 -[rfc-6265-5.2.1]: https://tools.ietf.org/html/rfc6265#section-5.2.1
234 -[rfc-6265-5.2.2]: https://tools.ietf.org/html/rfc6265#section-5.2.2
235 -[rfc-6265-5.2.3]: https://tools.ietf.org/html/rfc6265#section-5.2.3
236 -[rfc-6265-5.2.4]: https://tools.ietf.org/html/rfc6265#section-5.2.4
237 -[rfc-6265-5.2.5]: https://tools.ietf.org/html/rfc6265#section-5.2.5
238 -[rfc-6265-5.2.6]: https://tools.ietf.org/html/rfc6265#section-5.2.6
239 -[rfc-6265-5.3]: https://tools.ietf.org/html/rfc6265#section-5.3
240 -
241 -## License
242 -
243 -[MIT](LICENSE)
244 -
245 -[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/cookie/master
246 -[coveralls-url]: https://coveralls.io/r/jshttp/cookie?branch=master
247 -[node-version-image]: https://badgen.net/npm/node/cookie
248 -[node-version-url]: https://nodejs.org/en/download
249 -[npm-downloads-image]: https://badgen.net/npm/dm/cookie
250 -[npm-url]: https://npmjs.org/package/cookie
251 -[npm-version-image]: https://badgen.net/npm/v/cookie
252 -[travis-image]: https://badgen.net/travis/jshttp/cookie/master
253 -[travis-url]: https://travis-ci.org/jshttp/cookie
1 -/*!
2 - * cookie
3 - * Copyright(c) 2012-2014 Roman Shtylman
4 - * Copyright(c) 2015 Douglas Christopher Wilson
5 - * MIT Licensed
6 - */
7 -
8 -'use strict';
9 -
10 -/**
11 - * Module exports.
12 - * @public
13 - */
14 -
15 -exports.parse = parse;
16 -exports.serialize = serialize;
17 -
18 -/**
19 - * Module variables.
20 - * @private
21 - */
22 -
23 -var decode = decodeURIComponent;
24 -var encode = encodeURIComponent;
25 -var pairSplitRegExp = /; */;
26 -
27 -/**
28 - * RegExp to match field-content in RFC 7230 sec 3.2
29 - *
30 - * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ]
31 - * field-vchar = VCHAR / obs-text
32 - * obs-text = %x80-FF
33 - */
34 -
35 -var fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
36 -
37 -/**
38 - * Parse a cookie header.
39 - *
40 - * Parse the given cookie header string into an object
41 - * The object has the various cookies as keys(names) => values
42 - *
43 - * @param {string} str
44 - * @param {object} [options]
45 - * @return {object}
46 - * @public
47 - */
48 -
49 -function parse(str, options) {
50 - if (typeof str !== 'string') {
51 - throw new TypeError('argument str must be a string');
52 - }
53 -
54 - var obj = {}
55 - var opt = options || {};
56 - var pairs = str.split(pairSplitRegExp);
57 - var dec = opt.decode || decode;
58 -
59 - for (var i = 0; i < pairs.length; i++) {
60 - var pair = pairs[i];
61 - var eq_idx = pair.indexOf('=');
62 -
63 - // skip things that don't look like key=value
64 - if (eq_idx < 0) {
65 - continue;
66 - }
67 -
68 - var key = pair.substr(0, eq_idx).trim()
69 - var val = pair.substr(++eq_idx, pair.length).trim();
70 -
71 - // quoted values
72 - if ('"' == val[0]) {
73 - val = val.slice(1, -1);
74 - }
75 -
76 - // only assign once
77 - if (undefined == obj[key]) {
78 - obj[key] = tryDecode(val, dec);
79 - }
80 - }
81 -
82 - return obj;
83 -}
84 -
85 -/**
86 - * Serialize data into a cookie header.
87 - *
88 - * Serialize the a name value pair into a cookie string suitable for
89 - * http headers. An optional options object specified cookie parameters.
90 - *
91 - * serialize('foo', 'bar', { httpOnly: true })
92 - * => "foo=bar; httpOnly"
93 - *
94 - * @param {string} name
95 - * @param {string} val
96 - * @param {object} [options]
97 - * @return {string}
98 - * @public
99 - */
100 -
101 -function serialize(name, val, options) {
102 - var opt = options || {};
103 - var enc = opt.encode || encode;
104 -
105 - if (typeof enc !== 'function') {
106 - throw new TypeError('option encode is invalid');
107 - }
108 -
109 - if (!fieldContentRegExp.test(name)) {
110 - throw new TypeError('argument name is invalid');
111 - }
112 -
113 - var value = enc(val);
114 -
115 - if (value && !fieldContentRegExp.test(value)) {
116 - throw new TypeError('argument val is invalid');
117 - }
118 -
119 - var str = name + '=' + value;
120 -
121 - if (null != opt.maxAge) {
122 - var maxAge = opt.maxAge - 0;
123 - if (isNaN(maxAge)) throw new Error('maxAge should be a Number');
124 - str += '; Max-Age=' + Math.floor(maxAge);
125 - }
126 -
127 - if (opt.domain) {
128 - if (!fieldContentRegExp.test(opt.domain)) {
129 - throw new TypeError('option domain is invalid');
130 - }
131 -
132 - str += '; Domain=' + opt.domain;
133 - }
134 -
135 - if (opt.path) {
136 - if (!fieldContentRegExp.test(opt.path)) {
137 - throw new TypeError('option path is invalid');
138 - }
139 -
140 - str += '; Path=' + opt.path;
141 - }
142 -
143 - if (opt.expires) {
144 - if (typeof opt.expires.toUTCString !== 'function') {
145 - throw new TypeError('option expires is invalid');
146 - }
147 -
148 - str += '; Expires=' + opt.expires.toUTCString();
149 - }
150 -
151 - if (opt.httpOnly) {
152 - str += '; HttpOnly';
153 - }
154 -
155 - if (opt.secure) {
156 - str += '; Secure';
157 - }
158 -
159 - if (opt.sameSite) {
160 - var sameSite = typeof opt.sameSite === 'string'
161 - ? opt.sameSite.toLowerCase() : opt.sameSite;
162 -
163 - switch (sameSite) {
164 - case true:
165 - str += '; SameSite=Strict';
166 - break;
167 - case 'lax':
168 - str += '; SameSite=Lax';
169 - break;
170 - case 'strict':
171 - str += '; SameSite=Strict';
172 - break;
173 - case 'none':
174 - str += '; SameSite=None';
175 - break;
176 - default:
177 - throw new TypeError('option sameSite is invalid');
178 - }
179 - }
180 -
181 - return str;
182 -}
183 -
184 -/**
185 - * Try decoding a string using a decoding function.
186 - *
187 - * @param {string} str
188 - * @param {function} decode
189 - * @private
190 - */
191 -
192 -function tryDecode(str, decode) {
193 - try {
194 - return decode(str);
195 - } catch (e) {
196 - return str;
197 - }
198 -}
1 -{
2 - "_args": [
3 - [
4 - "cookie@0.4.0",
5 - "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory"
6 - ]
7 - ],
8 - "_from": "cookie@0.4.0",
9 - "_id": "cookie@0.4.0",
10 - "_inBundle": false,
11 - "_integrity": "sha512-+Hp8fLp57wnUSt0tY0tHEXh4voZRDnoIrZPqlo3DPiI4y9lwg/jqx+1Om94/W6ZaPDOUbnjOt/99w66zk+l1Xg==",
12 - "_location": "/cookie",
13 - "_phantomChildren": {},
14 - "_requested": {
15 - "type": "version",
16 - "registry": true,
17 - "raw": "cookie@0.4.0",
18 - "name": "cookie",
19 - "escapedName": "cookie",
20 - "rawSpec": "0.4.0",
21 - "saveSpec": null,
22 - "fetchSpec": "0.4.0"
23 - },
24 - "_requiredBy": [
25 - "/express"
26 - ],
27 - "_resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.0.tgz",
28 - "_spec": "0.4.0",
29 - "_where": "C:\\Users\\fheld\\Desktop\\khuhub\\mapmory\\Mapmory",
30 - "author": {
31 - "name": "Roman Shtylman",
32 - "email": "shtylman@gmail.com"
33 - },
34 - "bugs": {
35 - "url": "https://github.com/jshttp/cookie/issues"
36 - },
37 - "contributors": [
38 - {
39 - "name": "Douglas Christopher Wilson",
40 - "email": "doug@somethingdoug.com"
41 - }
42 - ],
43 - "description": "HTTP server cookie parsing and serialization",
44 - "devDependencies": {
45 - "beautify-benchmark": "0.2.4",
46 - "benchmark": "2.1.4",
47 - "eslint": "5.16.0",
48 - "eslint-plugin-markdown": "1.0.0",
49 - "istanbul": "0.4.5",
50 - "mocha": "6.1.4"
51 - },
52 - "engines": {
53 - "node": ">= 0.6"
54 - },
55 - "files": [
56 - "HISTORY.md",
57 - "LICENSE",
58 - "README.md",
59 - "index.js"
60 - ],
61 - "homepage": "https://github.com/jshttp/cookie#readme",
62 - "keywords": [
63 - "cookie",
64 - "cookies"
65 - ],
66 - "license": "MIT",
67 - "name": "cookie",
68 - "repository": {
69 - "type": "git",
70 - "url": "git+https://github.com/jshttp/cookie.git"
71 - },
72 - "scripts": {
73 - "bench": "node benchmark/index.js",
74 - "lint": "eslint --plugin markdown --ext js,md .",
75 - "test": "mocha --reporter spec --bail --check-leaks test/",
76 - "test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --reporter spec --check-leaks test/",
77 - "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --reporter dot --check-leaks test/",
78 - "version": "node scripts/version-history.js && git add HISTORY.md"
79 - },
80 - "version": "0.4.0"
81 -}
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff could not be displayed because it is too large.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff could not be displayed because it is too large.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff could not be displayed because it is too large.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.
This diff is collapsed. Click to expand it.