- -## Features - - - Integers and decimals - - Simple API but full-featured - - Faster, smaller, and perhaps easier to use than JavaScript versions of Java's BigDecimal - - 8 KB minified and gzipped - - Replicates the `toExponential`, `toFixed`, `toPrecision` and `toString` methods of JavaScript's Number type - - Includes a `toFraction` and a correctly-rounded `squareRoot` method - - Supports cryptographically-secure pseudo-random number generation - - No dependencies - - Wide platform compatibility: uses JavaScript 1.5 (ECMAScript 3) features only - - Comprehensive [documentation](http://mikemcl.github.io/bignumber.js/) and test set - - - -If a smaller and simpler library is required see [big.js](https://github.com/MikeMcl/big.js/). -It's less than half the size but only works with decimal numbers and only has half the methods. -It also does not allow `NaN` or `Infinity`, or have the configuration options of this library. - -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. - -## Load - -The library is the single JavaScript file *bignumber.js* (or minified, *bignumber.min.js*). - -Browser: - -```html - -``` - -[Node.js](http://nodejs.org): - -```bash -$ npm install bignumber.js -``` - -```javascript -const BigNumber = require('bignumber.js'); -``` - -ES6 module: - -```javascript -import BigNumber from "./bignumber.mjs" -``` - -AMD loader libraries such as [requireJS](http://requirejs.org/): - -```javascript -require(['bignumber'], function(BigNumber) { - // Use BigNumber here in local scope. No global BigNumber. -}); -``` - -## Use - -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, - -```javascript -let x = new BigNumber(123.4567); -let y = BigNumber('123456.7e-3'); -let z = new BigNumber(x); -x.isEqualTo(y) && y.isEqualTo(z) && x.isEqualTo(z); // true -``` - -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. - -```javascript -let x = new BigNumber('1111222233334444555566'); -x.toString(); // "1.111222233334444555566e+21" -x.toFixed(); // "1111222233334444555566" -``` - -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. - -*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.* - -```javascript -// Precision loss from using numeric literals with more than 15 significant digits. -new BigNumber(1.0000000000000001) // '1' -new BigNumber(88259496234518.57) // '88259496234518.56' -new BigNumber(99999999999999999999) // '100000000000000000000' - -// Precision loss from using numeric literals outside the range of Number values. -new BigNumber(2e+308) // 'Infinity' -new BigNumber(1e-324) // '0' - -// Precision loss from the unexpected result of arithmetic with Number values. -new BigNumber(0.7 + 0.1) // '0.7999999999999999' -``` - -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. - -```javascript -new BigNumber(Number.MAX_VALUE.toString(2), 2) -``` - -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. - -```javascript -a = new BigNumber(1011, 2) // "11" -b = new BigNumber('zz.9', 36) // "1295.25" -c = a.plus(b) // "1306.25" -``` - -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. - -A BigNumber is immutable in the sense that it is not changed by its methods. - -```javascript -0.3 - 0.1 // 0.19999999999999998 -x = new BigNumber(0.3) -x.minus(0.1) // "0.2" -x // "0.3" -``` - -The methods that return a BigNumber can be chained. - -```javascript -x.dividedBy(y).plus(z).times(9) -x.times('1.23456780123456789e+9').plus(9876.5432321).dividedBy('4444562598.111772').integerValue() -``` - -Some of the longer method names have a shorter alias. - -```javascript -x.squareRoot().dividedBy(y).exponentiatedBy(3).isEqualTo(x.sqrt().div(y).pow(3)) // true -x.modulo(y).multipliedBy(z).eq(x.mod(y).times(z)) // true -``` - -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. - -```javascript -x = new BigNumber(255.5) -x.toExponential(5) // "2.55500e+2" -x.toFixed(5) // "255.50000" -x.toPrecision(5) // "255.50" -x.toNumber() // 255.5 -``` - - 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. - - ```javascript - x.toString(16) // "ff.8" - ``` - -There is a [`toFormat`](http://mikemcl.github.io/bignumber.js/#toFor) method which may be useful for internationalisation. - -```javascript -y = new BigNumber('1234567.898765') -y.toFormat(2) // "1,234,567.90" -``` - -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. - -The other arithmetic operations always give the exact result. - -```javascript -BigNumber.set({ DECIMAL_PLACES: 10, ROUNDING_MODE: 4 }) - -x = new BigNumber(2) -y = new BigNumber(3) -z = x.dividedBy(y) // "0.6666666667" -z.squareRoot() // "0.8164965809" -z.exponentiatedBy(-3) // "3.3749999995" -z.toString(2) // "0.1010101011" -z.multipliedBy(z) // "0.44444444448888888889" -z.multipliedBy(z).decimalPlaces(10) // "0.4444444445" -``` - -There is a [`toFraction`](http://mikemcl.github.io/bignumber.js/#toFr) method with an optional *maximum denominator* argument - -```javascript -y = new BigNumber(355) -pi = y.dividedBy(113) // "3.1415929204" -pi.toFraction() // [ "7853982301", "2500000000" ] -pi.toFraction(1000) // [ "355", "113" ] -``` - -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. - -```javascript -x = new BigNumber(NaN) // "NaN" -y = new BigNumber(Infinity) // "Infinity" -x.isNaN() && !y.isNaN() && !x.isFinite() && !y.isFinite() // true -``` - -The value of a BigNumber is stored in a decimal floating point format in terms of a coefficient, exponent and sign. - -```javascript -x = new BigNumber(-123.456); -x.c // [ 123, 45600000000000 ] coefficient (i.e. significand) -x.e // 2 exponent -x.s // -1 sign -``` - -For advanced usage, multiple BigNumber constructors can be created, each with their own independent configuration. - -```javascript -// Set DECIMAL_PLACES for the original BigNumber constructor -BigNumber.set({ DECIMAL_PLACES: 10 }) - -// Create another BigNumber constructor, optionally passing in a configuration object -BN = BigNumber.clone({ DECIMAL_PLACES: 5 }) - -x = new BigNumber(1) -y = new BN(1) - -x.div(3) // '0.3333333333' -y.div(3) // '0.33333' -``` - -For further information see the [API](http://mikemcl.github.io/bignumber.js/) reference in the *doc* directory. - -## Test - -The *test/modules* directory contains the test scripts for each method. - -The tests can be run with Node.js or a browser. For Node.js use - - $ npm test - -or - - $ node test/test - -To test a single method, use, for example - - $ node test/methods/toFraction - -For the browser, open *test/test.html*. - -## Build - -For Node, if [uglify-js](https://github.com/mishoo/UglifyJS2) is installed - - npm install uglify-js -g - -then - - npm run build - -will create *bignumber.min.js*. - -A source map will also be created in the root directory. - -## Feedback - -Open an issue, or email - -Michael - -M8ch88l@gmail.com - -## Licence - -The MIT Licence. - -See [LICENCE](https://github.com/MikeMcl/bignumber.js/blob/master/LICENCE). diff --git a/node_modules/bignumber.js/bignumber.d.ts b/node_modules/bignumber.js/bignumber.d.ts deleted file mode 100644 index ac6a3e4..0000000 --- a/node_modules/bignumber.js/bignumber.d.ts +++ /dev/null @@ -1,1829 +0,0 @@ -// Type definitions for bignumber.js >=8.1.0 -// Project: https://github.com/MikeMcl/bignumber.js -// Definitions by: Michael Mclaughlin
-
-
- BigNumber
- clone
-
- config
-
-
- isBigNumber
- maximum
- minimum
-
- random
- sum
-
-
- absoluteValue
-
- comparedTo
-
-
-
- decimalPlaces
- dividedBy
-
- dividedToIntegerBy
-
- exponentiatedBy
-
- integerValue
- isEqualTo
- isFinite
- isGreaterThan
-
- isGreaterThanOrEqualTo
- isInteger
- isLessThan
-
- isLessThanOrEqualTo
- isNaN
- isNegative
- isPositive
- isZero
-
- minus
- modulo
-
- multipliedBy
- negated
- plus
-
- precision
- shiftedBy
- squareRoot
-
- toExponential
-
- toFixed
-
- toFormat
-
- toFraction
- toJSON
- toNumber
-
- toPrecision
- toString
- valueOf
-
-
-
-
-
-
-
-
-
-
diff --git a/node_modules/bignumber.js/package.json b/node_modules/bignumber.js/package.json
deleted file mode 100644
index 885136c..0000000
--- a/node_modules/bignumber.js/package.json
+++ /dev/null
@@ -1,40 +0,0 @@
-{
- "name": "bignumber.js",
- "description": "A library for arbitrary-precision decimal and non-decimal arithmetic",
- "version": "9.0.0",
- "keywords": [
- "arbitrary",
- "precision",
- "arithmetic",
- "big",
- "number",
- "decimal",
- "float",
- "biginteger",
- "bigdecimal",
- "bignumber",
- "bigint",
- "bignum"
- ],
- "repository": {
- "type": "git",
- "url": "https://github.com/MikeMcl/bignumber.js.git"
- },
- "main": "bignumber",
- "module": "bignumber.mjs",
- "browser": "bignumber.js",
- "types": "bignumber.d.ts",
- "author": {
- "name": "Michael Mclaughlin",
- "email": "M8ch88l@gmail.com"
- },
- "engines": {
- "node": "*"
- },
- "license": "MIT",
- "scripts": {
- "test": "node test/test",
- "build": "uglifyjs bignumber.js --source-map -c -m -o bignumber.min.js"
- },
- "dependencies": {}
-}
diff --git a/node_modules/body-parser/HISTORY.md b/node_modules/body-parser/HISTORY.md
index fb212b3..b892491 100644
--- a/node_modules/body-parser/HISTORY.md
+++ b/node_modules/body-parser/HISTORY.md
@@ -1,3 +1,11 @@
+1.20.2 / 2023-02-21
+===================
+
+ * Fix strict json error message on Node.js 19+
+ * deps: content-type@~1.0.5
+ - perf: skip value escaping when unnecessary
+ * deps: raw-body@2.5.2
+
1.20.1 / 2022-10-06
===================
diff --git a/node_modules/body-parser/README.md b/node_modules/body-parser/README.md
index c507cbb..38553bf 100644
--- a/node_modules/body-parser/README.md
+++ b/node_modules/body-parser/README.md
@@ -1,8 +1,8 @@
# body-parser
-[![NPM Version][npm-image]][npm-url]
-[![NPM Downloads][downloads-image]][downloads-url]
-[![Build Status][github-actions-ci-image]][github-actions-ci-url]
+[![NPM Version][npm-version-image]][npm-url]
+[![NPM Downloads][npm-downloads-image]][npm-url]
+[![Build Status][ci-image]][ci-url]
[![Test Coverage][coveralls-image]][coveralls-url]
Node.js body parsing middleware.
@@ -454,11 +454,12 @@ app.use(bodyParser.text({ type: 'text/html' }))
[MIT](LICENSE)
-[npm-image]: https://img.shields.io/npm/v/body-parser.svg
-[npm-url]: https://npmjs.org/package/body-parser
-[coveralls-image]: https://img.shields.io/coveralls/expressjs/body-parser/master.svg
+[ci-image]: https://badgen.net/github/checks/expressjs/body-parser/master?label=ci
+[ci-url]: https://github.com/expressjs/body-parser/actions/workflows/ci.yml
+[coveralls-image]: https://badgen.net/coveralls/c/github/expressjs/body-parser/master
[coveralls-url]: https://coveralls.io/r/expressjs/body-parser?branch=master
-[downloads-image]: https://img.shields.io/npm/dm/body-parser.svg
-[downloads-url]: https://npmjs.org/package/body-parser
-[github-actions-ci-image]: https://img.shields.io/github/workflow/status/expressjs/body-parser/ci/master?label=ci
-[github-actions-ci-url]: https://github.com/expressjs/body-parser/actions/workflows/ci.yml
+[node-version-image]: https://badgen.net/npm/node/body-parser
+[node-version-url]: https://nodejs.org/en/download
+[npm-downloads-image]: https://badgen.net/npm/dm/body-parser
+[npm-url]: https://npmjs.org/package/body-parser
+[npm-version-image]: https://badgen.net/npm/v/body-parser
diff --git a/node_modules/body-parser/lib/types/json.js b/node_modules/body-parser/lib/types/json.js
index c2745be..59f3f7e 100644
--- a/node_modules/body-parser/lib/types/json.js
+++ b/node_modules/body-parser/lib/types/json.js
@@ -39,6 +39,9 @@ module.exports = json
var FIRST_CHAR_REGEXP = /^[\x20\x09\x0a\x0d]*([^\x20\x09\x0a\x0d])/ // eslint-disable-line no-control-regex
+var JSON_SYNTAX_CHAR = '#'
+var JSON_SYNTAX_REGEXP = /#+/g
+
/**
* Create a middleware to parse JSON bodies.
*
@@ -152,15 +155,23 @@ function json (options) {
function createStrictSyntaxError (str, char) {
var index = str.indexOf(char)
- var partial = index !== -1
- ? str.substring(0, index) + '#'
- : ''
+ var partial = ''
+
+ if (index !== -1) {
+ partial = str.substring(0, index) + JSON_SYNTAX_CHAR
+
+ for (var i = index + 1; i < str.length; i++) {
+ partial += JSON_SYNTAX_CHAR
+ }
+ }
try {
JSON.parse(partial); /* istanbul ignore next */ throw new SyntaxError('strict violation')
} catch (e) {
return normalizeJsonSyntaxError(e, {
- message: e.message.replace('#', char),
+ message: e.message.replace(JSON_SYNTAX_REGEXP, function (placeholder) {
+ return str.substring(index, index + placeholder.length)
+ }),
stack: e.stack
})
}
diff --git a/node_modules/body-parser/package.json b/node_modules/body-parser/package.json
index 9cd2ccb..4637304 100644
--- a/node_modules/body-parser/package.json
+++ b/node_modules/body-parser/package.json
@@ -1,7 +1,7 @@
{
"name": "body-parser",
"description": "Node.js body parsing middleware",
- "version": "1.20.1",
+ "version": "1.20.2",
"contributors": [
"Douglas Christopher Wilson bignumber.js
- -A JavaScript library for arbitrary-precision arithmetic.
- - -API
- -- See the README on GitHub for a - quick-start introduction. -
-
- In all examples below, var and semicolons are not shown, and if a commented-out
- value is in quotes it means toString has been called on the preceding expression.
-
CONSTRUCTOR
- - -
- BigNumberBigNumber(n [, base]) ⇒ BigNumber
-
-
- n: number|string|BigNumber
- base: number: integer, 2 to 36 inclusive. (See
- ALPHABET to extend this range).
-
- Returns a new instance of a BigNumber object with value n, where n
- is a numeric value in the specified base, or base 10 if
- base is omitted or is null or undefined.
-
-x = new BigNumber(123.4567) // '123.4567' -// 'new' is optional -y = BigNumber(x) // '123.4567'-
- If n is a base 10 value it can be in normal (fixed-point) or
- exponential notation. Values in other bases must be in normal notation. Values in any base can
- have fraction digits, i.e. digits after the decimal point.
-
-new BigNumber(43210) // '43210'
-new BigNumber('4.321e+4') // '43210'
-new BigNumber('-735.0918e-430') // '-7.350918e-428'
-new BigNumber('123412421.234324', 5) // '607236.557696'
-
- Signed 0, signed Infinity and NaN are supported.
-
-new BigNumber('-Infinity') // '-Infinity'
-new BigNumber(NaN) // 'NaN'
-new BigNumber(-0) // '0'
-new BigNumber('.5') // '0.5'
-new BigNumber('+2') // '2'
-
- String values in hexadecimal literal form, e.g. '0xff', are valid, as are
- string values with the octal and binary prefixs '0o' and '0b'.
- String values in octal literal form without the prefix will be interpreted as
- decimals, e.g. '011' is interpreted as 11, not 9.
-
-new BigNumber(-10110100.1, 2) // '-180.5'
-new BigNumber('-0b10110100.1') // '-180.5'
-new BigNumber('ff.8', 16) // '255.5'
-new BigNumber('0xff.8') // '255.5'
-
- If a base is specified, n is rounded according to the current
- DECIMAL_PLACES and
- ROUNDING_MODE settings. This includes base
- 10 so don't include a base parameter for decimal values unless
- this behaviour is wanted.
-
BigNumber.config({ DECIMAL_PLACES: 5 })
-new BigNumber(1.23456789) // '1.23456789'
-new BigNumber(1.23456789, 10) // '1.23457'
- An error is thrown if base is invalid. See Errors.
- There is no limit to the number of digits of a value of type string (other than
- that of JavaScript's maximum array size). See RANGE to set
- the maximum and minimum possible exponent value of a BigNumber.
-
-new BigNumber('5032485723458348569331745.33434346346912144534543')
-new BigNumber('4.321e10000000')
- BigNumber NaN is returned if n is invalid
- (unless BigNumber.DEBUG is true, see below).
-new BigNumber('.1*') // 'NaN'
-new BigNumber('blurgh') // 'NaN'
-new BigNumber(9, 2) // 'NaN'
-
- To aid in debugging, if BigNumber.DEBUG is true then an error will
- be thrown on an invalid n. An error will also be thrown if n is of
- type number with more than 15 significant digits, as calling
- toString or valueOf on
- these numbers may not result in the intended value.
-
-console.log(823456789123456.3) // 823456789123456.2 -new BigNumber(823456789123456.3) // '823456789123456.2' -BigNumber.DEBUG = true -// '[BigNumber Error] Number primitive has more than 15 significant digits' -new BigNumber(823456789123456.3) -// '[BigNumber Error] Not a base 2 number' -new BigNumber(9, 2)-
- A BigNumber can also be created from an object literal.
- Use isBigNumber to check that it is well-formed.
-
new BigNumber({ s: 1, e: 2, c: [ 777, 12300000000000 ], _isBigNumber: true }) // '777.123'
-
-
-
-
- Methods
-The static methods of a BigNumber constructor.
- - - - -clone
- .clone([object]) ⇒ BigNumber constructor
-
- object: object
- Returns a new independent BigNumber constructor with configuration as described by
- object (see config), or with the default
- configuration if object is null or undefined.
-
- Throws if object is not an object. See Errors.
-
BigNumber.config({ DECIMAL_PLACES: 5 })
-BN = BigNumber.clone({ DECIMAL_PLACES: 9 })
-
-x = new BigNumber(1)
-y = new BN(1)
-
-x.div(3) // 0.33333
-y.div(3) // 0.333333333
-
-// BN = BigNumber.clone({ DECIMAL_PLACES: 9 }) is equivalent to:
-BN = BigNumber.clone()
-BN.config({ DECIMAL_PLACES: 9 })
-
-
-
- configset([object]) ⇒ object
-
- object: object: an object that contains some or all of the following
- properties.
-
Configures the settings for this particular BigNumber constructor.
- --
-
DECIMAL_PLACES
- -
- number: integer,
0to1e+9inclusive
- Default value:20-
- -
- The maximum number of decimal places of the results of operations involving
- division, i.e. division, square root and base conversion operations, and power
- operations with negative exponents.
-
- -
-
BigNumber.config({ DECIMAL_PLACES: 5 }) -BigNumber.set({ DECIMAL_PLACES: 5 }) // equivalent-
-
-
-
- ROUNDING_MODE
- -
- number: integer,
0to8inclusive
- Default value:4(ROUND_HALF_UP) -
- -
- The rounding mode used in the above operations and the default rounding mode of
-
decimalPlaces, -precision, -toExponential, -toFixed, -toFormatand -toPrecision. -
- - The modes are available as enumerated properties of the BigNumber constructor. -
-
-
BigNumber.config({ ROUNDING_MODE: 0 }) -BigNumber.set({ ROUNDING_MODE: BigNumber.ROUND_UP }) // equivalent-
-
-
-
- EXPONENTIAL_AT
- -
- number: integer, magnitude
0to1e+9inclusive, or -
- number[]: [ integer-1e+9to0inclusive, integer -0to1e+9inclusive ]
- Default value:[-7, 20]-
- -
- The exponent value(s) at which
toStringreturns exponential notation. -
- -
- If a single number is assigned, the value is the exponent magnitude.
- If an array of two numbers is assigned then the first number is the negative exponent - value at and beneath which exponential notation is used, and the second number is the - positive exponent value at and above which the same. -
- -
- For example, to emulate JavaScript numbers in terms of the exponent values at which they
- begin to use exponential notation, use
[-7, 20]. -
- -
-
BigNumber.config({ EXPONENTIAL_AT: 2 }) -new BigNumber(12.3) // '12.3' e is only 1 -new BigNumber(123) // '1.23e+2' -new BigNumber(0.123) // '0.123' e is only -1 -new BigNumber(0.0123) // '1.23e-2' - -BigNumber.config({ EXPONENTIAL_AT: [-7, 20] }) -new BigNumber(123456789) // '123456789' e is only 8 -new BigNumber(0.000000123) // '1.23e-7' - -// Almost never return exponential notation: -BigNumber.config({ EXPONENTIAL_AT: 1e+9 }) - -// Always return exponential notation: -BigNumber.config({ EXPONENTIAL_AT: 0 })-
- -
- Regardless of the value of
EXPONENTIAL_AT, thetoFixedmethod - will always return a value in normal notation and thetoExponentialmethod - will always return a value in exponential form. -
- -
- Calling
toStringwith a base argument, e.g.toString(10), will - also always return normal notation. -
-
-
-
- RANGE
- -
- number: integer, magnitude
1to1e+9inclusive, or -
- number[]: [ integer-1e+9to-1inclusive, integer -1to1e+9inclusive ]
- Default value:[-1e+9, 1e+9]-
- -
- The exponent value(s) beyond which overflow to
Infinityand underflow to - zero occurs. -
- -
- If a single number is assigned, it is the maximum exponent magnitude: values wth a
- positive exponent of greater magnitude become
Infinityand those with a - negative exponent of greater magnitude become zero. -- - If an array of two numbers is assigned then the first number is the negative exponent - limit and the second number is the positive exponent limit. -
-- - For example, to emulate JavaScript numbers in terms of the exponent values at which they - become zero and
-Infinity, use[-324, 308]. -- -
-BigNumber.config({ RANGE: 500 }) -BigNumber.config().RANGE // [ -500, 500 ] -new BigNumber('9.999e499') // '9.999e+499' -new BigNumber('1e500') // 'Infinity' -new BigNumber('1e-499') // '1e-499' -new BigNumber('1e-500') // '0' - -BigNumber.config({ RANGE: [-3, 4] }) -new BigNumber(99999) // '99999' e is only 4 -new BigNumber(100000) // 'Infinity' e is 5 -new BigNumber(0.001) // '0.01' e is only -3 -new BigNumber(0.0001) // '0' e is -4-- - The largest possible magnitude of a finite BigNumber is -
- - - -9.999...e+1000000000.
- The smallest possible magnitude of a non-zero BigNumber is1e-1000000000. - CRYPTO
- -
- boolean:
trueorfalse.
- Default value:false-
- - - The value that determines whether cryptographically-secure pseudo-random number - generation is used. - -
-
- If
CRYPTOis set totruethen the -randommethod will generate random digits using -crypto.getRandomValuesin browsers that support it, or -crypto.randomBytesif using Node.js. -
- -
- If neither function is supported by the host environment then attempting to set
-
CRYPTOtotruewill fail and an exception will be thrown. -
- -
- If
CRYPTOisfalsethen the source of randomness used will be -Math.random(which is assumed to generate at least30bits of - randomness). -
- - See
random.
- -
-
-// Node.js -global.crypto = require('crypto') - -BigNumber.config({ CRYPTO: true }) -BigNumber.config().CRYPTO // true -BigNumber.random() // 0.54340758610486147524-
-
-
-
- MODULO_MODE
- -
- number: integer,
0to9inclusive
- Default value:1(ROUND_DOWN) -
- - The modulo mode used when calculating the modulus:
a mod n.
- -
- The quotient,
q = a / n, is calculated according to the -ROUNDING_MODEthat corresponds to the chosen -MODULO_MODE. -
- - The remainder,
r, is calculated as:r = a - n * q.
- - - The modes that are most commonly used for the modulus/remainder operation are shown in - the following table. Although the other rounding modes can be used, they may not give - useful results. - -
-
-
-
-Property Value Description - -ROUND_UP 0 -- The remainder is positive if the dividend is negative, otherwise it is negative. - -- -ROUND_DOWN 1 -- The remainder has the same sign as the dividend. -
- This uses 'truncating division' and matches the behaviour of JavaScript's - remainder operator%. -- -ROUND_FLOOR 3 -- The remainder has the same sign as the divisor. -
- This matches Python's%operator. -- -ROUND_HALF_EVEN 6 -The IEEE 754 remainder function. -- -EUCLID 9 -- The remainder is always positive. Euclidian division: -
-q = sign(n) * floor(a / abs(n))-
- - - The rounding/modulo modes are available as enumerated properties of the BigNumber - constructor. - -
- See
modulo.
- -
-
BigNumber.config({ MODULO_MODE: BigNumber.EUCLID }) -BigNumber.config({ MODULO_MODE: 9 }) // equivalent-
-
-
-
- POW_PRECISION
- -
- number: integer,
0to1e+9inclusive.
- Default value:0-
- - - The maximum precision, i.e. number of significant digits, of the result of the power - operation (unless a modulus is specified). - -
- If set to
0, the number of significant digits will not be limited.
- - See
exponentiatedBy.
- BigNumber.config({ POW_PRECISION: 100 })
-
-
-
- FORMAT
- - object -
-
- The
FORMATobject configures the format of the string returned by the -toFormatmethod. -
- -
- The example below shows the properties of the
FORMATobject that are - recognised, and their default values. -
- -
- Unlike the other configuration properties, the values of the properties of the
-
FORMATobject will not be checked for validity. The existing -FORMATobject will simply be replaced by the object that is passed in. - The object can include any number of the properties shown below. -
- - See
toFormatfor examples of usage.
- -
-
-BigNumber.config({ - FORMAT: { - // string to prepend - prefix: '', - // decimal separator - decimalSeparator: '.', - // grouping separator of the integer part - groupSeparator: ',', - // primary grouping size of the integer part - groupSize: 3, - // secondary grouping size of the integer part - secondaryGroupSize: 0, - // grouping separator of the fraction part - fractionGroupSeparator: ' ', - // grouping size of the fraction part - fractionGroupSize: 0, - // string to append - suffix: '' - } -});-
-
-
-
- ALPHABET
- -
- string
- Default value:'0123456789abcdefghijklmnopqrstuvwxyz'-
- -
- The alphabet used for base conversion. The length of the alphabet corresponds to the
- maximum value of the base argument that can be passed to the
-
BigNumberconstructor or -toString. -
- -
- There is no maximum length for the alphabet, but it must be at least 2 characters long, and
- it must not contain whitespace or a repeated character, or the sign indicators
-
'+'and'-', or the decimal separator'.'. -
- -
-
// duodecimal (base 12) -BigNumber.config({ ALPHABET: '0123456789TE' }) -x = new BigNumber('T', 12) -x.toString() // '10' -x.toString(12) // 'T'-
-
-
-
-
-
Returns an object with the above properties and their current values.
-
- Throws if object is not an object, or if an invalid value is assigned to
- one or more of the above properties. See Errors.
-
-BigNumber.config({
- DECIMAL_PLACES: 40,
- ROUNDING_MODE: BigNumber.ROUND_HALF_CEIL,
- EXPONENTIAL_AT: [-10, 20],
- RANGE: [-500, 500],
- CRYPTO: true,
- MODULO_MODE: BigNumber.ROUND_FLOOR,
- POW_PRECISION: 80,
- FORMAT: {
- groupSize: 3,
- groupSeparator: ' ',
- decimalSeparator: ','
- },
- ALPHABET: '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ$_'
-});
-
-obj = BigNumber.config();
-obj.DECIMAL_PLACES // 40
-obj.RANGE // [-500, 500]
-
-
-
-
- isBigNumber.isBigNumber(value) ⇒ boolean
-
- value: any
- Returns true if value is a BigNumber instance, otherwise returns
- false.
-
x = 42 -y = new BigNumber(x) - -BigNumber.isBigNumber(x) // false -y instanceof BigNumber // true -BigNumber.isBigNumber(y) // true - -BN = BigNumber.clone(); -z = new BN(x) -z instanceof BigNumber // false -BigNumber.isBigNumber(z) // true-
- If value is a BigNumber instance and BigNumber.DEBUG is true,
- then this method will also check if value is well-formed, and throw if it is not.
- See Errors.
-
- The check can be useful if creating a BigNumber from an object literal. - See BigNumber. -
--x = new BigNumber(10) - -// Change x.c to an illegitimate value. -x.c = NaN - -BigNumber.DEBUG = false - -// No error. -BigNumber.isBigNumber(x) // true - -BigNumber.DEBUG = true - -// Error. -BigNumber.isBigNumber(x) // '[BigNumber Error] Invalid BigNumber'- - - -
maximum.max(n...) ⇒ BigNumber
-
- n: number|string|BigNumber
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the maximum of the arguments. -
-The return value is always exact and unrounded.
-x = new BigNumber('3257869345.0378653')
-BigNumber.maximum(4e9, x, '123456789.9') // '4000000000'
-
-arr = [12, '13', new BigNumber(14)]
-BigNumber.max.apply(null, arr) // '14'
-
-
-
- minimum.min(n...) ⇒ BigNumber
-
- n: number|string|BigNumber
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the minimum of the arguments. -
-The return value is always exact and unrounded.
-x = new BigNumber('3257869345.0378653')
-BigNumber.minimum(4e9, x, '123456789.9') // '123456789.9'
-
-arr = [2, new BigNumber(-14), '-15.9999', -12]
-BigNumber.min.apply(null, arr) // '-15.9999'
-
-
-
-
- random.random([dp]) ⇒ BigNumber
-
- dp: number: integer, 0 to 1e+9 inclusive
- Returns a new BigNumber with a pseudo-random value equal to or greater than 0 and
- less than 1.
-
- The return value will have dp decimal places (or less if trailing zeros are
- produced).
- If dp is omitted then the number of decimal places will default to the current
- DECIMAL_PLACES setting.
-
- Depending on the value of this BigNumber constructor's
- CRYPTO setting and the support for the
- crypto object in the host environment, the random digits of the return value are
- generated by either Math.random (fastest), crypto.getRandomValues
- (Web Cryptography API in recent browsers) or crypto.randomBytes (Node.js).
-
- To be able to set CRYPTO to true when using
- Node.js, the crypto object must be available globally:
-
global.crypto = require('crypto')
-
- If CRYPTO is true, i.e. one of the
- crypto methods is to be used, the value of a returned BigNumber should be
- cryptographically-secure and statistically indistinguishable from a random value.
-
- Throws if dp is invalid. See Errors.
-
BigNumber.config({ DECIMAL_PLACES: 10 })
-BigNumber.random() // '0.4117936847'
-BigNumber.random(20) // '0.78193327636914089009'
-
-
-
- sum.sum(n...) ⇒ BigNumber
-
- n: number|string|BigNumber
- See BigNumber for further parameter details.
-
Returns a BigNumber whose value is the sum of the arguments.
-The return value is always exact and unrounded.
-x = new BigNumber('3257869345.0378653')
-BigNumber.sum(4e9, x, '123456789.9') // '7381326134.9378653'
-
-arr = [2, new BigNumber(14), '15.9999', 12]
-BigNumber.sum.apply(null, arr) // '43.9999'
-
-
-
- Properties
-
- The library's enumerated rounding modes are stored as properties of the constructor.
- (They are not referenced internally by the library itself.)
-
- Rounding modes 0 to 6 (inclusive) are the same as those of Java's
- BigDecimal class.
-
| Property | -Value | -Description | -
|---|---|---|
| ROUND_UP | -0 | -Rounds away from zero | -
| ROUND_DOWN | -1 | -Rounds towards zero | -
| ROUND_CEIL | -2 | -Rounds towards Infinity |
-
| ROUND_FLOOR | -3 | -Rounds towards -Infinity |
-
| ROUND_HALF_UP | -4 | -
- Rounds towards nearest neighbour. - If equidistant, rounds away from zero - |
-
| ROUND_HALF_DOWN | -5 | -
- Rounds towards nearest neighbour. - If equidistant, rounds towards zero - |
-
| ROUND_HALF_EVEN | -6 | -
- Rounds towards nearest neighbour. - If equidistant, rounds towards even neighbour - |
-
| ROUND_HALF_CEIL | -7 | -
- Rounds towards nearest neighbour. - If equidistant, rounds towards Infinity
- |
-
| ROUND_HALF_FLOOR | -8 | -
- Rounds towards nearest neighbour. - If equidistant, rounds towards -Infinity
- |
-
-BigNumber.config({ ROUNDING_MODE: BigNumber.ROUND_CEIL })
-BigNumber.config({ ROUNDING_MODE: 2 }) // equivalent
-
- DEBUG
-undefined|false|true
-
- If BigNumber.DEBUG is set true then an error will be thrown
- if this BigNumber constructor receives an invalid value, such as
- a value of type number with more than 15 significant digits.
- See BigNumber.
-
- An error will also be thrown if the isBigNumber
- method receives a BigNumber that is not well-formed.
- See isBigNumber.
-
BigNumber.DEBUG = true- - -
INSTANCE
- - -Methods
-The methods inherited by a BigNumber instance from its constructor's prototype object.
-A BigNumber is immutable in the sense that it is not changed by its methods.
-
- The treatment of ±0, ±Infinity and NaN is
- consistent with how JavaScript treats these values.
-
Many method names have a shorter alias.
- - - -absoluteValue.abs() ⇒ BigNumber
- - Returns a BigNumber whose value is the absolute value, i.e. the magnitude, of the value of - this BigNumber. -
-The return value is always exact and unrounded.
--x = new BigNumber(-0.8) -y = x.absoluteValue() // '0.8' -z = y.abs() // '0.8'- - - -
- comparedTo.comparedTo(n [, base]) ⇒ number
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
| Returns | |
|---|---|
1 |
- If the value of this BigNumber is greater than the value of n |
-
-1 |
- If the value of this BigNumber is less than the value of n |
-
0 |
- If this BigNumber and n have the same value |
-
null |
- If the value of either this BigNumber or n is NaN |
-
-x = new BigNumber(Infinity)
-y = new BigNumber(5)
-x.comparedTo(y) // 1
-x.comparedTo(x.minus(1)) // 0
-y.comparedTo(NaN) // null
-y.comparedTo('110', 2) // -1
-
-
-
-
- decimalPlaces.dp([dp [, rm]]) ⇒ BigNumber|number
-
-
- dp: number: integer, 0 to 1e+9 inclusive
- rm: number: integer, 0 to 8 inclusive
-
- If dp is a number, returns a BigNumber whose value is the value of this BigNumber
- rounded by rounding mode rm to a maximum of dp decimal places.
-
- If dp is omitted, or is null or undefined, the return
- value is the number of decimal places of the value of this BigNumber, or null if
- the value of this BigNumber is ±Infinity or NaN.
-
- If rm is omitted, or is null or undefined,
- ROUNDING_MODE is used.
-
- Throws if dp or rm is invalid. See Errors.
-
-x = new BigNumber(1234.56)
-x.decimalPlaces(1) // '1234.6'
-x.dp() // 2
-x.decimalPlaces(2) // '1234.56'
-x.dp(10) // '1234.56'
-x.decimalPlaces(0, 1) // '1234'
-x.dp(0, 6) // '1235'
-x.decimalPlaces(1, 1) // '1234.5'
-x.dp(1, BigNumber.ROUND_HALF_EVEN) // '1234.6'
-x // '1234.56'
-y = new BigNumber('9.9e-101')
-y.dp() // 102
-
-
-
- dividedBy.div(n [, base]) ⇒ BigNumber
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the value of this BigNumber divided by
- n, rounded according to the current
- DECIMAL_PLACES and
- ROUNDING_MODE settings.
-
-x = new BigNumber(355) -y = new BigNumber(113) -x.dividedBy(y) // '3.14159292035398230088' -x.div(5) // '71' -x.div(47, 16) // '5'- - - -
- dividedToIntegerBy.idiv(n [, base]) ⇒
- BigNumber
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the integer part of dividing the value of this BigNumber by
- n.
-
-x = new BigNumber(5)
-y = new BigNumber(3)
-x.dividedToIntegerBy(y) // '1'
-x.idiv(0.7) // '7'
-x.idiv('0.f', 16) // '5'
-
-
-
-
- exponentiatedBy.pow(n [, m]) ⇒ BigNumber
-
-
- n: number|string|BigNumber: integer
- m: number|string|BigNumber
-
- Returns a BigNumber whose value is the value of this BigNumber exponentiated by
- n, i.e. raised to the power n, and optionally modulo a modulus
- m.
-
- Throws if n is not an integer. See Errors.
-
- If n is negative the result is rounded according to the current
- DECIMAL_PLACES and
- ROUNDING_MODE settings.
-
- As the number of digits of the result of the power operation can grow so large so quickly,
- e.g. 123.45610000 has over 50000 digits, the number of significant
- digits calculated is limited to the value of the
- POW_PRECISION setting (unless a modulus
- m is specified).
-
- By default POW_PRECISION is set to 0.
- This means that an unlimited number of significant digits will be calculated, and that the
- method's performance will decrease dramatically for larger exponents.
-
- If m is specified and the value of m, n and this
- BigNumber are integers, and n is positive, then a fast modular exponentiation
- algorithm is used, otherwise the operation will be performed as
- x.exponentiatedBy(n).modulo(m) with a
- POW_PRECISION of 0.
-
-Math.pow(0.7, 2) // 0.48999999999999994 -x = new BigNumber(0.7) -x.exponentiatedBy(2) // '0.49' -BigNumber(3).pow(-2) // '0.11111111111111111111'- - - -
- integerValue.integerValue([rm]) ⇒ BigNumber
-
-
- rm: number: integer, 0 to 8 inclusive
-
- Returns a BigNumber whose value is the value of this BigNumber rounded to an integer using
- rounding mode rm.
-
- If rm is omitted, or is null or undefined,
- ROUNDING_MODE is used.
-
- Throws if rm is invalid. See Errors.
-
-x = new BigNumber(123.456) -x.integerValue() // '123' -x.integerValue(BigNumber.ROUND_CEIL) // '124' -y = new BigNumber(-12.7) -y.integerValue() // '-13' -y.integerValue(BigNumber.ROUND_DOWN) // '-12'-
- The following is an example of how to add a prototype method that emulates JavaScript's
- Math.round function. Math.ceil, Math.floor and
- Math.trunc can be emulated in the same way with
- BigNumber.ROUND_CEIL, BigNumber.ROUND_FLOOR and
- BigNumber.ROUND_DOWN respectively.
-
-BigNumber.prototype.round = function (n) {
- return n.integerValue(BigNumber.ROUND_HALF_CEIL);
-};
-x.round() // '123'
-
-
-
- isEqualTo.eq(n [, base]) ⇒ boolean
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns true if the value of this BigNumber is equal to the value of
- n, otherwise returns false.
- As with JavaScript, NaN does not equal NaN.
-
Note: This method uses the comparedTo method internally.
-0 === 1e-324 // true
-x = new BigNumber(0)
-x.isEqualTo('1e-324') // false
-BigNumber(-0).eq(x) // true ( -0 === 0 )
-BigNumber(255).eq('ff', 16) // true
-
-y = new BigNumber(NaN)
-y.isEqualTo(NaN) // false
-
-
-
- isFinite.isFinite() ⇒ boolean
-
- Returns true if the value of this BigNumber is a finite number, otherwise
- returns false.
-
- The only possible non-finite values of a BigNumber are NaN, Infinity
- and -Infinity.
-
-x = new BigNumber(1) -x.isFinite() // true -y = new BigNumber(Infinity) -y.isFinite() // false-
- Note: The native method isFinite() can be used if
- n <= Number.MAX_VALUE.
-
isGreaterThan.gt(n [, base]) ⇒ boolean
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns true if the value of this BigNumber is greater than the value of
- n, otherwise returns false.
-
Note: This method uses the comparedTo method internally.
-0.1 > (0.3 - 0.2) // true -x = new BigNumber(0.1) -x.isGreaterThan(BigNumber(0.3).minus(0.2)) // false -BigNumber(0).gt(x) // false -BigNumber(11, 3).gt(11.1, 2) // true- - - -
- isGreaterThanOrEqualTo.gte(n [, base]) ⇒ boolean
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns true if the value of this BigNumber is greater than or equal to the value
- of n, otherwise returns false.
-
Note: This method uses the comparedTo method internally.
-(0.3 - 0.2) >= 0.1 // false
-x = new BigNumber(0.3).minus(0.2)
-x.isGreaterThanOrEqualTo(0.1) // true
-BigNumber(1).gte(x) // true
-BigNumber(10, 18).gte('i', 36) // true
-
-
-
- isInteger.isInteger() ⇒ boolean
-
- Returns true if the value of this BigNumber is an integer, otherwise returns
- false.
-
-x = new BigNumber(1) -x.isInteger() // true -y = new BigNumber(123.456) -y.isInteger() // false- - - -
isLessThan.lt(n [, base]) ⇒ boolean
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns true if the value of this BigNumber is less than the value of
- n, otherwise returns false.
-
Note: This method uses the comparedTo method internally.
-(0.3 - 0.2) < 0.1 // true -x = new BigNumber(0.3).minus(0.2) -x.isLessThan(0.1) // false -BigNumber(0).lt(x) // true -BigNumber(11.1, 2).lt(11, 3) // true- - - -
- isLessThanOrEqualTo.lte(n [, base]) ⇒ boolean
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns true if the value of this BigNumber is less than or equal to the value of
- n, otherwise returns false.
-
Note: This method uses the comparedTo method internally.
-0.1 <= (0.3 - 0.2) // false
-x = new BigNumber(0.1)
-x.isLessThanOrEqualTo(BigNumber(0.3).minus(0.2)) // true
-BigNumber(-1).lte(x) // true
-BigNumber(10, 18).lte('i', 36) // true
-
-
-
- isNaN.isNaN() ⇒ boolean
-
- Returns true if the value of this BigNumber is NaN, otherwise
- returns false.
-
-x = new BigNumber(NaN)
-x.isNaN() // true
-y = new BigNumber('Infinity')
-y.isNaN() // false
- Note: The native method isNaN() can also be used.
isNegative.isNegative() ⇒ boolean
-
- Returns true if the sign of this BigNumber is negative, otherwise returns
- false.
-
-x = new BigNumber(-0) -x.isNegative() // true -y = new BigNumber(2) -y.isNegative() // false-
Note: n < 0 can be used if n <= -Number.MIN_VALUE.
isPositive.isPositive() ⇒ boolean
-
- Returns true if the sign of this BigNumber is positive, otherwise returns
- false.
-
-x = new BigNumber(-0) -x.isPositive() // false -y = new BigNumber(2) -y.isPositive() // true- - - -
isZero.isZero() ⇒ boolean
-
- Returns true if the value of this BigNumber is zero or minus zero, otherwise
- returns false.
-
-x = new BigNumber(-0) -x.isZero() && x.isNegative() // true -y = new BigNumber(Infinity) -y.isZero() // false-
Note: n == 0 can be used if n >= Number.MIN_VALUE.
- minus.minus(n [, base]) ⇒ BigNumber
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
Returns a BigNumber whose value is the value of this BigNumber minus n.
The return value is always exact and unrounded.
--0.3 - 0.1 // 0.19999999999999998 -x = new BigNumber(0.3) -x.minus(0.1) // '0.2' -x.minus(0.6, 20) // '0'- - - -
modulo.mod(n [, base]) ⇒ BigNumber
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the value of this BigNumber modulo n, i.e.
- the integer remainder of dividing this BigNumber by n.
-
- The value returned, and in particular its sign, is dependent on the value of the
- MODULO_MODE setting of this BigNumber constructor.
- If it is 1 (default value), the result will have the same sign as this BigNumber,
- and it will match that of Javascript's % operator (within the limits of double
- precision) and BigDecimal's remainder method.
-
The return value is always exact and unrounded.
-
- See MODULO_MODE for a description of the other
- modulo modes.
-
-1 % 0.9 // 0.09999999999999998
-x = new BigNumber(1)
-x.modulo(0.9) // '0.1'
-y = new BigNumber(33)
-y.mod('a', 33) // '3'
-
-
-
-
- multipliedBy.times(n [, base]) ⇒ BigNumber
-
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
- Returns a BigNumber whose value is the value of this BigNumber multiplied by n.
-
The return value is always exact and unrounded.
-
-0.6 * 3 // 1.7999999999999998
-x = new BigNumber(0.6)
-y = x.multipliedBy(3) // '1.8'
-BigNumber('7e+500').times(y) // '1.26e+501'
-x.multipliedBy('-a', 16) // '-6'
-
-
-
- negated.negated() ⇒ BigNumber
-
- Returns a BigNumber whose value is the value of this BigNumber negated, i.e. multiplied by
- -1.
-
-x = new BigNumber(1.8) -x.negated() // '-1.8' -y = new BigNumber(-1.3) -y.negated() // '1.3'- - - -
plus.plus(n [, base]) ⇒ BigNumber
-
- n: number|string|BigNumber
- base: number
- See BigNumber for further parameter details.
-
Returns a BigNumber whose value is the value of this BigNumber plus n.
The return value is always exact and unrounded.
-
-0.1 + 0.2 // 0.30000000000000004
-x = new BigNumber(0.1)
-y = x.plus(0.2) // '0.3'
-BigNumber(0.7).plus(x).plus(y) // '1'
-x.plus('0.1', 8) // '0.225'
-
-
-
-
- precision.sd([d [, rm]]) ⇒ BigNumber|number
-
-
- d: number|boolean: integer, 1 to 1e+9
- inclusive, or true or false
- rm: number: integer, 0 to 8 inclusive.
-
- If d is a number, returns a BigNumber whose value is the value of this BigNumber
- rounded to a precision of d significant digits using rounding mode
- rm.
-
- If d is omitted or is null or undefined, the return
- value is the number of significant digits of the value of this BigNumber, or null
- if the value of this BigNumber is ±Infinity or NaN.
- If d is true then any trailing zeros of the integer
- part of a number are counted as significant digits, otherwise they are not.
-
- If rm is omitted or is null or undefined,
- ROUNDING_MODE will be used.
-
- Throws if d or rm is invalid. See Errors.
-
-x = new BigNumber(9876.54321) -x.precision(6) // '9876.54' -x.sd() // 9 -x.precision(6, BigNumber.ROUND_UP) // '9876.55' -x.sd(2) // '9900' -x.precision(2, 1) // '9800' -x // '9876.54321' -y = new BigNumber(987000) -y.precision() // 3 -y.sd(true) // 6- - - -
shiftedBy.shiftedBy(n) ⇒ BigNumber
-
- n: number: integer,
- -9007199254740991 to 9007199254740991 inclusive
-
- Returns a BigNumber whose value is the value of this BigNumber shifted by n
- places.
-
- The shift is of the decimal point, i.e. of powers of ten, and is to the left if n
- is negative or to the right if n is positive.
-
The return value is always exact and unrounded.
-
- Throws if n is invalid. See Errors.
-
-x = new BigNumber(1.23) -x.shiftedBy(3) // '1230' -x.shiftedBy(-3) // '0.00123'- - - -
squareRoot.sqrt() ⇒ BigNumber
-
- Returns a BigNumber whose value is the square root of the value of this BigNumber,
- rounded according to the current
- DECIMAL_PLACES and
- ROUNDING_MODE settings.
-
- The return value will be correctly rounded, i.e. rounded as if the result was first calculated - to an infinite number of correct digits before rounding. -
--x = new BigNumber(16) -x.squareRoot() // '4' -y = new BigNumber(3) -y.sqrt() // '1.73205080756887729353'- - - -
- toExponential.toExponential([dp [, rm]]) ⇒ string
-
-
- dp: number: integer, 0 to 1e+9 inclusive
- rm: number: integer, 0 to 8 inclusive
-
- Returns a string representing the value of this BigNumber in exponential notation rounded
- using rounding mode rm to dp decimal places, i.e with one digit
- before the decimal point and dp digits after it.
-
- If the value of this BigNumber in exponential notation has fewer than dp fraction
- digits, the return value will be appended with zeros accordingly.
-
- If dp is omitted, or is null or undefined, the number
- of digits after the decimal point defaults to the minimum number of digits necessary to
- represent the value exactly.
- If rm is omitted or is null or undefined,
- ROUNDING_MODE is used.
-
- Throws if dp or rm is invalid. See Errors.
-
-x = 45.6 -y = new BigNumber(x) -x.toExponential() // '4.56e+1' -y.toExponential() // '4.56e+1' -x.toExponential(0) // '5e+1' -y.toExponential(0) // '5e+1' -x.toExponential(1) // '4.6e+1' -y.toExponential(1) // '4.6e+1' -y.toExponential(1, 1) // '4.5e+1' (ROUND_DOWN) -x.toExponential(3) // '4.560e+1' -y.toExponential(3) // '4.560e+1'- - - -
- toFixed.toFixed([dp [, rm]]) ⇒ string
-
-
- dp: number: integer, 0 to 1e+9 inclusive
- rm: number: integer, 0 to 8 inclusive
-
- Returns a string representing the value of this BigNumber in normal (fixed-point) notation
- rounded to dp decimal places using rounding mode rm.
-
- If the value of this BigNumber in normal notation has fewer than dp fraction
- digits, the return value will be appended with zeros accordingly.
-
- Unlike Number.prototype.toFixed, which returns exponential notation if a number
- is greater or equal to 1021, this method will always return normal
- notation.
-
- If dp is omitted or is null or undefined, the return
- value will be unrounded and in normal notation. This is also unlike
- Number.prototype.toFixed, which returns the value to zero decimal places.
- It is useful when fixed-point notation is required and the current
- EXPONENTIAL_AT setting causes
- toString to return exponential notation.
- If rm is omitted or is null or undefined,
- ROUNDING_MODE is used.
-
- Throws if dp or rm is invalid. See Errors.
-
-x = 3.456 -y = new BigNumber(x) -x.toFixed() // '3' -y.toFixed() // '3.456' -y.toFixed(0) // '3' -x.toFixed(2) // '3.46' -y.toFixed(2) // '3.46' -y.toFixed(2, 1) // '3.45' (ROUND_DOWN) -x.toFixed(5) // '3.45600' -y.toFixed(5) // '3.45600'- - - -
- toFormat.toFormat([dp [, rm[, format]]]) ⇒ string
-
-
- dp: number: integer, 0 to 1e+9 inclusive
- rm: number: integer, 0 to 8 inclusive
- format: object: see FORMAT
-
-
- Returns a string representing the value of this BigNumber in normal (fixed-point) notation
- rounded to dp decimal places using rounding mode rm, and formatted
- according to the properties of the format object.
-
- See FORMAT and the examples below for the properties of the
- format object, their types, and their usage. A formatting object may contain
- some or all of the recognised properties.
-
- If dp is omitted or is null or undefined, then the
- return value is not rounded to a fixed number of decimal places.
- If rm is omitted or is null or undefined,
- ROUNDING_MODE is used.
- If format is omitted or is null or undefined, the
- FORMAT object is used.
-
- Throws if dp, rm or format is invalid. See
- Errors.
-
-fmt = {
- prefix = '',
- decimalSeparator: '.',
- groupSeparator: ',',
- groupSize: 3,
- secondaryGroupSize: 0,
- fractionGroupSeparator: ' ',
- fractionGroupSize: 0,
- suffix = ''
-}
-
-x = new BigNumber('123456789.123456789')
-
-// Set the global formatting options
-BigNumber.config({ FORMAT: fmt })
-
-x.toFormat() // '123,456,789.123456789'
-x.toFormat(3) // '123,456,789.123'
-
-// If a reference to the object assigned to FORMAT has been retained,
-// the format properties can be changed directly
-fmt.groupSeparator = ' '
-fmt.fractionGroupSize = 5
-x.toFormat() // '123 456 789.12345 6789'
-
-// Alternatively, pass the formatting options as an argument
-fmt = {
- prefix: '=> ',
- decimalSeparator: ',',
- groupSeparator: '.',
- groupSize: 3,
- secondaryGroupSize: 2
-}
-
-x.toFormat() // '123 456 789.12345 6789'
-x.toFormat(fmt) // '=> 12.34.56.789,123456789'
-x.toFormat(2, fmt) // '=> 12.34.56.789,12'
-x.toFormat(3, BigNumber.ROUND_UP, fmt) // '=> 12.34.56.789,124'
-
-
-
-
- toFraction.toFraction([maximum_denominator])
- ⇒ [BigNumber, BigNumber]
-
-
- maximum_denominator:
- number|string|BigNumber: integer >= 1 and <=
- Infinity
-
- Returns an array of two BigNumbers representing the value of this BigNumber as a simple
- fraction with an integer numerator and an integer denominator. The denominator will be a
- positive non-zero value less than or equal to maximum_denominator.
-
- If a maximum_denominator is not specified, or is null or
- undefined, the denominator will be the lowest value necessary to represent the
- number exactly.
-
- Throws if maximum_denominator is invalid. See Errors.
-
-x = new BigNumber(1.75)
-x.toFraction() // '7, 4'
-
-pi = new BigNumber('3.14159265358')
-pi.toFraction() // '157079632679,50000000000'
-pi.toFraction(100000) // '312689, 99532'
-pi.toFraction(10000) // '355, 113'
-pi.toFraction(100) // '311, 99'
-pi.toFraction(10) // '22, 7'
-pi.toFraction(1) // '3, 1'
-
-
-
- toJSON.toJSON() ⇒ string
- As valueOf.
-x = new BigNumber('177.7e+457')
-y = new BigNumber(235.4325)
-z = new BigNumber('0.0098074')
-
-// Serialize an array of three BigNumbers
-str = JSON.stringify( [x, y, z] )
-// "["1.777e+459","235.4325","0.0098074"]"
-
-// Return an array of three BigNumbers
-JSON.parse(str, function (key, val) {
- return key === '' ? val : new BigNumber(val)
-})
-
-
-
- toNumber.toNumber() ⇒ number
- Returns the value of this BigNumber as a JavaScript number primitive.
-- This method is identical to using type coercion with the unary plus operator. -
-
-x = new BigNumber(456.789)
-x.toNumber() // 456.789
-+x // 456.789
-
-y = new BigNumber('45987349857634085409857349856430985')
-y.toNumber() // 4.598734985763409e+34
-
-z = new BigNumber(-0)
-1 / z.toNumber() // -Infinity
-1 / +z // -Infinity
-
-
-
-
- toPrecision.toPrecision([sd [, rm]]) ⇒ string
-
-
- sd: number: integer, 1 to 1e+9 inclusive
- rm: number: integer, 0 to 8 inclusive
-
- Returns a string representing the value of this BigNumber rounded to sd
- significant digits using rounding mode rm.
-
- If sd is less than the number of digits necessary to represent the integer part
- of the value in normal (fixed-point) notation, then exponential notation is used.
-
- If sd is omitted, or is null or undefined, then the
- return value is the same as n.toString().
- If rm is omitted or is null or undefined,
- ROUNDING_MODE is used.
-
- Throws if sd or rm is invalid. See Errors.
-
-x = 45.6 -y = new BigNumber(x) -x.toPrecision() // '45.6' -y.toPrecision() // '45.6' -x.toPrecision(1) // '5e+1' -y.toPrecision(1) // '5e+1' -y.toPrecision(2, 0) // '4.6e+1' (ROUND_UP) -y.toPrecision(2, 1) // '4.5e+1' (ROUND_DOWN) -x.toPrecision(5) // '45.600' -y.toPrecision(5) // '45.600'- - - -
toString.toString([base]) ⇒ string
-
- base: number: integer, 2 to ALPHABET.length
- inclusive (see ALPHABET).
-
- Returns a string representing the value of this BigNumber in the specified base, or base
- 10 if base is omitted or is null or
- undefined.
-
- For bases above 10, and using the default base conversion alphabet
- (see ALPHABET), values from 10 to
- 35 are represented by a-z
- (as with Number.prototype.toString).
-
- If a base is specified the value is rounded according to the current
- DECIMAL_PLACES
- and ROUNDING_MODE settings.
-
- If a base is not specified, and this BigNumber has a positive
- exponent that is equal to or greater than the positive component of the
- current EXPONENTIAL_AT setting,
- or a negative exponent equal to or less than the negative component of the
- setting, then exponential notation is returned.
-
If base is null or undefined it is ignored.
- Throws if base is invalid. See Errors.
-
-x = new BigNumber(750000)
-x.toString() // '750000'
-BigNumber.config({ EXPONENTIAL_AT: 5 })
-x.toString() // '7.5e+5'
-
-y = new BigNumber(362.875)
-y.toString(2) // '101101010.111'
-y.toString(9) // '442.77777777777777777778'
-y.toString(32) // 'ba.s'
-
-BigNumber.config({ DECIMAL_PLACES: 4 });
-z = new BigNumber('1.23456789')
-z.toString() // '1.23456789'
-z.toString(10) // '1.2346'
-
-
-
- valueOf.valueOf() ⇒ string
-
- As toString, but does not accept a base argument and includes
- the minus sign for negative zero.
-
-x = new BigNumber('-0')
-x.toString() // '0'
-x.valueOf() // '-0'
-y = new BigNumber('1.777e+457')
-y.valueOf() // '1.777e+457'
-
-
-
- Properties
-The properties of a BigNumber instance:
-| Property | -Description | -Type | -Value | -
|---|---|---|---|
| c | -coefficient* | -number[] |
- Array of base 1e14 numbers |
-
| e | -exponent | -number | -Integer, -1000000000 to 1000000000 inclusive |
-
| s | -sign | -number | --1 or 1 |
-
*significand
-
- The value of any of the c, e and s properties may also
- be null.
-
- The above properties are best considered to be read-only. In early versions of this library it - was okay to change the exponent of a BigNumber by writing to its exponent property directly, - but this is no longer reliable as the value of the first element of the coefficient array is - now dependent on the exponent. -
-- Note that, as with JavaScript numbers, the original exponent and fractional trailing zeros are - not necessarily preserved. -
-x = new BigNumber(0.123) // '0.123'
-x.toExponential() // '1.23e-1'
-x.c // '1,2,3'
-x.e // -1
-x.s // 1
-
-y = new Number(-123.4567000e+2) // '-12345.67'
-y.toExponential() // '-1.234567e+4'
-z = new BigNumber('-123.4567000e+2') // '-12345.67'
-z.toExponential() // '-1.234567e+4'
-z.c // '1,2,3,4,5,6,7'
-z.e // 4
-z.s // -1
-
-
-
- Zero, NaN and Infinity
-
- The table below shows how ±0, NaN and
- ±Infinity are stored.
-
| - | c | -e | -s | -
|---|---|---|---|
| ±0 | -[0] |
- 0 |
- ±1 |
-
| NaN | -null |
- null |
- null |
-
| ±Infinity | -null |
- null |
- ±1 |
-
-x = new Number(-0) // 0 -1 / x == -Infinity // true - -y = new BigNumber(-0) // '0' -y.c // '0' ( [0].toString() ) -y.e // 0 -y.s // -1- - - -
Errors
-The table below shows the errors that are thrown.
-
- The errors are generic Error objects whose message begins
- '[BigNumber Error]'.
-
| Method | -Throws | -
|---|---|
- BigNumber- comparedTo- dividedBy- dividedToIntegerBy- isEqualTo- isGreaterThan- isGreaterThanOrEqualTo- isLessThan- isLessThanOrEqualTo- minus- modulo- plus- multipliedBy
- |
- Base not a primitive number | -
| Base not an integer | -|
| Base out of range | -|
| Number primitive has more than 15 significant digits* | -|
| Not a base... number* | -|
| Not a number* | -|
clone |
- Object expected | -
config |
- Object expected | -
DECIMAL_PLACES not a primitive number |
- |
DECIMAL_PLACES not an integer |
- |
DECIMAL_PLACES out of range |
- |
ROUNDING_MODE not a primitive number |
- |
ROUNDING_MODE not an integer |
- |
ROUNDING_MODE out of range |
- |
EXPONENTIAL_AT not a primitive number |
- |
EXPONENTIAL_AT not an integer |
- |
EXPONENTIAL_AT out of range |
- |
RANGE not a primitive number |
- |
RANGE not an integer |
- |
RANGE cannot be zero |
- |
RANGE cannot be zero |
- |
CRYPTO not true or false |
- |
crypto unavailable |
- |
MODULO_MODE not a primitive number |
- |
MODULO_MODE not an integer |
- |
MODULO_MODE out of range |
- |
POW_PRECISION not a primitive number |
- |
POW_PRECISION not an integer |
- |
POW_PRECISION out of range |
- |
FORMAT not an object |
- |
ALPHABET invalid |
- |
- decimalPlaces- precision- random- shiftedBy- toExponential- toFixed- toFormat- toPrecision
- |
- Argument not a primitive number | -
| Argument not an integer | -|
| Argument out of range | -|
- decimalPlaces- precision
- |
- Argument not true or false | -
exponentiatedBy |
- Argument not an integer | -
isBigNumber |
- Invalid BigNumber* | -
- minimum- maximum
- |
- Not a number* | -
- random
- |
- crypto unavailable | -
- toFormat
- |
- Argument not an object | -
toFraction |
- Argument not an integer | -
| Argument out of range | -|
toString |
- Base not a primitive number | -
| Base not an integer | -|
| Base out of range | -
*Only thrown if BigNumber.DEBUG is true.
To determine if an exception is a BigNumber Error:
-
-try {
- // ...
-} catch (e) {
- if (e instanceof Error && e.message.indexOf('[BigNumber Error]') === 0) {
- // ...
- }
-}
-
-
-
- Type coercion
-
- To prevent the accidental use of a BigNumber in primitive number operations, or the
- accidental addition of a BigNumber to a string, the valueOf method can be safely
- overwritten as shown below.
-
- The valueOf method is the same as the
- toJSON method, and both are the same as the
- toString method except they do not take a base
- argument and they include the minus sign for negative zero.
-
-BigNumber.prototype.valueOf = function () {
- throw Error('valueOf called!')
-}
-
-x = new BigNumber(1)
-x / 2 // '[BigNumber Error] valueOf called!'
-x + 'abc' // '[BigNumber Error] valueOf called!'
-
-
-
-
- FAQ
- -Why are trailing fractional zeros removed from BigNumbers?
-- Some arbitrary-precision libraries retain trailing fractional zeros as they can indicate the - precision of a value. This can be useful but the results of arithmetic operations can be - misleading. -
-
-x = new BigDecimal("1.0")
-y = new BigDecimal("1.1000")
-z = x.add(y) // 2.1000
-
-x = new BigDecimal("1.20")
-y = new BigDecimal("3.45000")
-z = x.multiply(y) // 4.1400000
- - To specify the precision of a value is to specify that the value lies - within a certain range. -
-
- In the first example, x has a value of 1.0. The trailing zero shows
- the precision of the value, implying that it is in the range 0.95 to
- 1.05. Similarly, the precision indicated by the trailing zeros of y
- indicates that the value is in the range 1.09995 to 1.10005.
-
- If we add the two lowest values in the ranges we have, 0.95 + 1.09995 = 2.04995,
- and if we add the two highest values we have, 1.05 + 1.10005 = 2.15005, so the
- range of the result of the addition implied by the precision of its operands is
- 2.04995 to 2.15005.
-
- The result given by BigDecimal of 2.1000 however, indicates that the value is in
- the range 2.09995 to 2.10005 and therefore the precision implied by
- its trailing zeros may be misleading.
-
- In the second example, the true range is 4.122744 to 4.157256 yet
- the BigDecimal answer of 4.1400000 indicates a range of 4.13999995
- to 4.14000005. Again, the precision implied by the trailing zeros may be
- misleading.
-
- This library, like binary floating point and most calculators, does not retain trailing
- fractional zeros. Instead, the toExponential, toFixed and
- toPrecision methods enable trailing zeros to be added if and when required.
-
Welcome back, ' + escapeHtml(name) + '!
'); - } else { - res.write('Hello, new visitor!
'); - } - - res.write(''); -} - -http.createServer(onRequest).listen(3000); -``` - -## Testing - -```sh -$ npm test -``` - -## Benchmark - -``` -$ npm run bench - -> cookie@0.4.2 bench -> node benchmark/index.js - - node@16.14.0 - v8@9.4.146.24-node.20 - uv@1.43.0 - zlib@1.2.11 - brotli@1.0.9 - ares@1.18.1 - modules@93 - nghttp2@1.45.1 - napi@8 - llhttp@6.0.4 - openssl@1.1.1m+quic - cldr@40.0 - icu@70.1 - tz@2021a3 - unicode@14.0 - ngtcp2@0.1.0-DEV - nghttp3@0.1.0-DEV - -> node benchmark/parse-top.js - - cookie.parse - top sites - - 15 tests completed. - - parse accounts.google.com x 2,421,245 ops/sec ±0.80% (188 runs sampled) - parse apple.com x 2,684,710 ops/sec ±0.59% (189 runs sampled) - parse cloudflare.com x 2,231,418 ops/sec ±0.76% (186 runs sampled) - parse docs.google.com x 2,316,357 ops/sec ±1.28% (187 runs sampled) - parse drive.google.com x 2,363,543 ops/sec ±0.49% (189 runs sampled) - parse en.wikipedia.org x 839,414 ops/sec ±0.53% (189 runs sampled) - parse linkedin.com x 553,797 ops/sec ±0.63% (190 runs sampled) - parse maps.google.com x 1,314,779 ops/sec ±0.72% (189 runs sampled) - parse microsoft.com x 153,783 ops/sec ±0.53% (190 runs sampled) - parse play.google.com x 2,249,574 ops/sec ±0.59% (187 runs sampled) - parse plus.google.com x 2,258,682 ops/sec ±0.60% (188 runs sampled) - parse sites.google.com x 2,247,069 ops/sec ±0.68% (189 runs sampled) - parse support.google.com x 1,456,840 ops/sec ±0.70% (187 runs sampled) - parse www.google.com x 1,046,028 ops/sec ±0.58% (188 runs sampled) - parse youtu.be x 937,428 ops/sec ±1.47% (190 runs sampled) - parse youtube.com x 963,878 ops/sec ±0.59% (190 runs sampled) - -> node benchmark/parse.js - - cookie.parse - generic - - 6 tests completed. - - simple x 2,745,604 ops/sec ±0.77% (185 runs sampled) - decode x 557,287 ops/sec ±0.60% (188 runs sampled) - unquote x 2,498,475 ops/sec ±0.55% (189 runs sampled) - duplicates x 868,591 ops/sec ±0.89% (187 runs sampled) - 10 cookies x 306,745 ops/sec ±0.49% (190 runs sampled) - 100 cookies x 22,414 ops/sec ±2.38% (182 runs sampled) -``` - -## References - -- [RFC 6265: HTTP State Management Mechanism][rfc-6265] -- [Same-site Cookies][rfc-6265bis-09-5.4.7] - -[rfc-west-cookie-priority-00-4.1]: https://tools.ietf.org/html/draft-west-cookie-priority-00#section-4.1 -[rfc-6265bis-09-5.4.7]: https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-09#section-5.4.7 -[rfc-6265]: https://tools.ietf.org/html/rfc6265 -[rfc-6265-5.1.4]: https://tools.ietf.org/html/rfc6265#section-5.1.4 -[rfc-6265-5.2.1]: https://tools.ietf.org/html/rfc6265#section-5.2.1 -[rfc-6265-5.2.2]: https://tools.ietf.org/html/rfc6265#section-5.2.2 -[rfc-6265-5.2.3]: https://tools.ietf.org/html/rfc6265#section-5.2.3 -[rfc-6265-5.2.4]: https://tools.ietf.org/html/rfc6265#section-5.2.4 -[rfc-6265-5.2.5]: https://tools.ietf.org/html/rfc6265#section-5.2.5 -[rfc-6265-5.2.6]: https://tools.ietf.org/html/rfc6265#section-5.2.6 -[rfc-6265-5.3]: https://tools.ietf.org/html/rfc6265#section-5.3 - -## License - -[MIT](LICENSE) - -[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/cookie/master -[coveralls-url]: https://coveralls.io/r/jshttp/cookie?branch=master -[github-actions-ci-image]: https://img.shields.io/github/workflow/status/jshttp/cookie/ci/master?label=ci -[github-actions-ci-url]: https://github.com/jshttp/cookie/actions/workflows/ci.yml -[node-version-image]: https://badgen.net/npm/node/cookie -[node-version-url]: https://nodejs.org/en/download -[npm-downloads-image]: https://badgen.net/npm/dm/cookie -[npm-url]: https://npmjs.org/package/cookie -[npm-version-image]: https://badgen.net/npm/v/cookie +# cookie + +[![NPM Version][npm-image]][npm-url] +[![NPM Downloads][downloads-image]][downloads-url] +[![Node.js Version][node-version-image]][node-version-url] +[![Build Status][travis-image]][travis-url] +[![Test Coverage][coveralls-image]][coveralls-url] + +cookie is a basic cookie parser and serializer. It doesn't make assumptions about how you are going to deal with your cookies. It basically just provides a way to read and write the HTTP cookie headers. + +See [RFC6265](http://tools.ietf.org/html/rfc6265) for details about the http header for cookies. + +## how? + +``` +npm install cookie +``` + +```javascript +var cookie = require('cookie'); + +var hdr = cookie.serialize('foo', 'bar'); +// hdr = 'foo=bar'; + +var cookies = cookie.parse('foo=bar; cat=meow; dog=ruff'); +// cookies = { foo: 'bar', cat: 'meow', dog: 'ruff' }; +``` + +## more + +The serialize function takes a third parameter, an object, to set cookie options. See the RFC for valid values. + +### path +> cookie path + +### expires +> absolute expiration date for the cookie (Date object) + +### maxAge +> relative max age of the cookie from when the client receives it (seconds) + +### domain +> domain for the cookie + +### secure +> true or false + +### httpOnly +> true or false + +## License + +[MIT](LICENSE) + +[npm-image]: https://img.shields.io/npm/v/cookie.svg +[npm-url]: https://npmjs.org/package/cookie +[node-version-image]: https://img.shields.io/node/v/cookie.svg +[node-version-url]: http://nodejs.org/download/ +[travis-image]: https://img.shields.io/travis/jshttp/cookie/master.svg +[travis-url]: https://travis-ci.org/jshttp/cookie +[coveralls-image]: https://img.shields.io/coveralls/jshttp/cookie/master.svg +[coveralls-url]: https://coveralls.io/r/jshttp/cookie?branch=master +[downloads-image]: https://img.shields.io/npm/dm/cookie.svg +[downloads-url]: https://npmjs.org/package/cookie diff --git a/node_modules/cookie/SECURITY.md b/node_modules/cookie/SECURITY.md deleted file mode 100644 index fd4a6c5..0000000 --- a/node_modules/cookie/SECURITY.md +++ /dev/null @@ -1,25 +0,0 @@ -# Security Policies and Procedures - -## Reporting a Bug - -The `cookie` team and community take all security bugs seriously. Thank -you for improving the security of the project. We appreciate your efforts and -responsible disclosure and will make every effort to acknowledge your -contributions. - -Report security bugs by emailing the current owner(s) of `cookie`. This -information can be found in the npm registry using the command -`npm owner ls cookie`. -If unsure or unable to get the information from the above, open an issue -in the [project issue tracker](https://github.com/jshttp/cookie/issues) -asking for the current contact information. - -To ensure the timely response to your report, please ensure that the entirety -of the report is contained within the email body and not solely behind a web -link or an attachment. - -At least one owner will acknowledge your email within 48 hours, and will send a -more detailed response within 48 hours indicating the next steps in handling -your report. After the initial reply to your report, the owners will -endeavor to keep you informed of the progress towards a fix and full -announcement, and may ask for additional information or guidance. diff --git a/node_modules/cookie/index.js b/node_modules/cookie/index.js index 9c3d07d..8dea066 100644 --- a/node_modules/cookie/index.js +++ b/node_modules/cookie/index.js @@ -1,270 +1,116 @@ -/*! - * cookie - * Copyright(c) 2012-2014 Roman Shtylman - * Copyright(c) 2015 Douglas Christopher Wilson - * MIT Licensed - */ - -'use strict'; - -/** - * Module exports. - * @public - */ - -exports.parse = parse; -exports.serialize = serialize; - -/** - * Module variables. - * @private - */ - -var __toString = Object.prototype.toString - -/** - * RegExp to match field-content in RFC 7230 sec 3.2 - * - * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ] - * field-vchar = VCHAR / obs-text - * obs-text = %x80-FF - */ - -var fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/; - -/** - * Parse a cookie header. - * - * Parse the given cookie header string into an object - * The object has the various cookies as keys(names) => values - * - * @param {string} str - * @param {object} [options] - * @return {object} - * @public - */ - -function parse(str, options) { - if (typeof str !== 'string') { - throw new TypeError('argument str must be a string'); - } - - var obj = {} - var opt = options || {}; - var dec = opt.decode || decode; - - var index = 0 - while (index < str.length) { - var eqIdx = str.indexOf('=', index) - - // no more cookie pairs - if (eqIdx === -1) { - break - } - - var endIdx = str.indexOf(';', index) - - if (endIdx === -1) { - endIdx = str.length - } else if (endIdx < eqIdx) { - // backtrack on prior semicolon - index = str.lastIndexOf(';', eqIdx - 1) + 1 - continue - } - - var key = str.slice(index, eqIdx).trim() - - // only assign once - if (undefined === obj[key]) { - var val = str.slice(eqIdx + 1, endIdx).trim() - - // quoted values - if (val.charCodeAt(0) === 0x22) { - val = val.slice(1, -1) - } - - obj[key] = tryDecode(val, dec); - } - - index = endIdx + 1 - } - - return obj; -} - -/** - * Serialize data into a cookie header. - * - * Serialize the a name value pair into a cookie string suitable for - * http headers. An optional options object specified cookie parameters. - * - * serialize('foo', 'bar', { httpOnly: true }) - * => "foo=bar; httpOnly" - * - * @param {string} name - * @param {string} val - * @param {object} [options] - * @return {string} - * @public - */ - -function serialize(name, val, options) { - var opt = options || {}; - var enc = opt.encode || encode; - - if (typeof enc !== 'function') { - throw new TypeError('option encode is invalid'); - } - - if (!fieldContentRegExp.test(name)) { - throw new TypeError('argument name is invalid'); - } - - var value = enc(val); - - if (value && !fieldContentRegExp.test(value)) { - throw new TypeError('argument val is invalid'); - } - - var str = name + '=' + value; - - if (null != opt.maxAge) { - var maxAge = opt.maxAge - 0; - - if (isNaN(maxAge) || !isFinite(maxAge)) { - throw new TypeError('option maxAge is invalid') - } - - str += '; Max-Age=' + Math.floor(maxAge); - } - - if (opt.domain) { - if (!fieldContentRegExp.test(opt.domain)) { - throw new TypeError('option domain is invalid'); - } - - str += '; Domain=' + opt.domain; - } - - if (opt.path) { - if (!fieldContentRegExp.test(opt.path)) { - throw new TypeError('option path is invalid'); - } - - str += '; Path=' + opt.path; - } - - if (opt.expires) { - var expires = opt.expires - - if (!isDate(expires) || isNaN(expires.valueOf())) { - throw new TypeError('option expires is invalid'); - } - - str += '; Expires=' + expires.toUTCString() - } - - if (opt.httpOnly) { - str += '; HttpOnly'; - } - - if (opt.secure) { - str += '; Secure'; - } - - if (opt.priority) { - var priority = typeof opt.priority === 'string' - ? opt.priority.toLowerCase() - : opt.priority - - switch (priority) { - case 'low': - str += '; Priority=Low' - break - case 'medium': - str += '; Priority=Medium' - break - case 'high': - str += '; Priority=High' - break - default: - throw new TypeError('option priority is invalid') - } - } - - if (opt.sameSite) { - var sameSite = typeof opt.sameSite === 'string' - ? opt.sameSite.toLowerCase() : opt.sameSite; - - switch (sameSite) { - case true: - str += '; SameSite=Strict'; - break; - case 'lax': - str += '; SameSite=Lax'; - break; - case 'strict': - str += '; SameSite=Strict'; - break; - case 'none': - str += '; SameSite=None'; - break; - default: - throw new TypeError('option sameSite is invalid'); - } - } - - return str; -} - -/** - * URL-decode string value. Optimized to skip native call when no %. - * - * @param {string} str - * @returns {string} - */ - -function decode (str) { - return str.indexOf('%') !== -1 - ? decodeURIComponent(str) - : str -} - -/** - * URL-encode value. - * - * @param {string} str - * @returns {string} - */ - -function encode (val) { - return encodeURIComponent(val) -} - -/** - * Determine if value is a Date. - * - * @param {*} val - * @private - */ - -function isDate (val) { - return __toString.call(val) === '[object Date]' || - val instanceof Date -} - -/** - * Try decoding a string using a decoding function. - * - * @param {string} str - * @param {function} decode - * @private - */ - -function tryDecode(str, decode) { - try { - return decode(str); - } catch (e) { - return str; - } -} +/*! + * cookie + * Copyright(c) 2012-2014 Roman Shtylman + * MIT Licensed + */ + +/** + * Module exports. + * @public + */ + +exports.parse = parse; +exports.serialize = serialize; + +/** + * Module variables. + * @private + */ + +var decode = decodeURIComponent; +var encode = encodeURIComponent; + +/** + * Parse a cookie header. + * + * Parse the given cookie header string into an object + * The object has the various cookies as keys(names) => values + * + * @param {string} str + * @param {object} [options] + * @return {string} + * @public + */ + +function parse(str, options) { + var obj = {} + var opt = options || {}; + var pairs = str.split(/; */); + var dec = opt.decode || decode; + + pairs.forEach(function(pair) { + var eq_idx = pair.indexOf('=') + + // skip things that don't look like key=value + if (eq_idx < 0) { + return; + } + + var key = pair.substr(0, eq_idx).trim() + var val = pair.substr(++eq_idx, pair.length).trim(); + + // quoted values + if ('"' == val[0]) { + val = val.slice(1, -1); + } + + // only assign once + if (undefined == obj[key]) { + obj[key] = tryDecode(val, dec); + } + }); + + return obj; +} + +/** + * Serialize data into a cookie header. + * + * Serialize the a name value pair into a cookie string suitable for + * http headers. An optional options object specified cookie parameters. + * + * serialize('foo', 'bar', { httpOnly: true }) + * => "foo=bar; httpOnly" + * + * @param {string} name + * @param {string} val + * @param {object} [options] + * @return {string} + * @public + */ + +function serialize(name, val, options) { + var opt = options || {}; + var enc = opt.encode || encode; + var pairs = [name + '=' + enc(val)]; + + if (null != opt.maxAge) { + var maxAge = opt.maxAge - 0; + if (isNaN(maxAge)) throw new Error('maxAge should be a Number'); + pairs.push('Max-Age=' + maxAge); + } + + if (opt.domain) pairs.push('Domain=' + opt.domain); + if (opt.path) pairs.push('Path=' + opt.path); + if (opt.expires) pairs.push('Expires=' + opt.expires.toUTCString()); + if (opt.httpOnly) pairs.push('HttpOnly'); + if (opt.secure) pairs.push('Secure'); + + return pairs.join('; '); +} + +/** + * Try decoding a string using a decoding function. + * + * @param {string} str + * @param {function} decode + * @private + */ + +function tryDecode(str, decode) { + try { + return decode(str); + } catch (e) { + return str; + } +} diff --git a/node_modules/cookie/package.json b/node_modules/cookie/package.json index ed5606a..09f305f 100644 --- a/node_modules/cookie/package.json +++ b/node_modules/cookie/package.json @@ -1,44 +1,29 @@ -{ - "name": "cookie", - "description": "HTTP server cookie parsing and serialization", - "version": "0.5.0", - "author": "Roman Shtylman+
Denque
+ + +
+ 
+ 
+ 
+ 
+ 
+ 
+
+
+ 
+
+
+ Built and maintained by Invertase. +
+ diff --git a/node_modules/denque/index.d.ts b/node_modules/denque/index.d.ts new file mode 100644 index 0000000..e125dd4 --- /dev/null +++ b/node_modules/denque/index.d.ts @@ -0,0 +1,47 @@ +declare class DenqueLocation ' + escapeHtml(url) + ' not found
' - - // send a 404 - res.statusCode = 404 - res.setHeader('Content-Type', 'text/html; charset=UTF-8') - res.setHeader('Content-Length', String(Buffer.byteLength(body, 'utf-8'))) - res.end(body, 'utf-8') -}) -``` - -### Encode a URL for use in a header field - -```js -var encodeUrl = require('encodeurl') -var escapeHtml = require('escape-html') -var url = require('url') - -http.createServer(function onRequest (req, res) { - // parse inbound url - var href = url.parse(req) - - // set new host for redirect - href.host = 'localhost' - href.protocol = 'https:' - href.slashes = true - - // create location header - var location = encodeUrl(url.format(href)) - - // create html message - var body = 'Redirecting to new site: ' + escapeHtml(location) + '
' - - // send a 301 - res.statusCode = 301 - res.setHeader('Content-Type', 'text/html; charset=UTF-8') - res.setHeader('Content-Length', String(Buffer.byteLength(body, 'utf-8'))) - res.setHeader('Location', location) - res.end(body, 'utf-8') -}) -``` - -## Testing - -```sh -$ npm test -$ npm run lint -``` - -## References - -- [RFC 3986: Uniform Resource Identifier (URI): Generic Syntax][rfc-3986] -- [WHATWG URL Living Standard][whatwg-url] - -[rfc-3986]: https://tools.ietf.org/html/rfc3986 -[whatwg-url]: https://url.spec.whatwg.org/ - -## License - -[MIT](LICENSE) - -[npm-image]: https://img.shields.io/npm/v/encodeurl.svg -[npm-url]: https://npmjs.org/package/encodeurl -[node-version-image]: https://img.shields.io/node/v/encodeurl.svg -[node-version-url]: https://nodejs.org/en/download -[travis-image]: https://img.shields.io/travis/pillarjs/encodeurl.svg -[travis-url]: https://travis-ci.org/pillarjs/encodeurl -[coveralls-image]: https://img.shields.io/coveralls/pillarjs/encodeurl.svg -[coveralls-url]: https://coveralls.io/r/pillarjs/encodeurl?branch=master -[downloads-image]: https://img.shields.io/npm/dm/encodeurl.svg -[downloads-url]: https://npmjs.org/package/encodeurl diff --git a/node_modules/encodeurl/index.js b/node_modules/encodeurl/index.js deleted file mode 100644 index fc4906c..0000000 --- a/node_modules/encodeurl/index.js +++ /dev/null @@ -1,60 +0,0 @@ -/*! - * encodeurl - * Copyright(c) 2016 Douglas Christopher Wilson - * MIT Licensed - */ - -'use strict' - -/** - * Module exports. - * @public - */ - -module.exports = encodeUrl - -/** - * RegExp to match non-URL code points, *after* encoding (i.e. not including "%") - * and including invalid escape sequences. - * @private - */ - -var ENCODE_CHARS_REGEXP = /(?:[^\x21\x25\x26-\x3B\x3D\x3F-\x5B\x5D\x5F\x61-\x7A\x7E]|%(?:[^0-9A-Fa-f]|[0-9A-Fa-f][^0-9A-Fa-f]|$))+/g - -/** - * RegExp to match unmatched surrogate pair. - * @private - */ - -var UNMATCHED_SURROGATE_PAIR_REGEXP = /(^|[^\uD800-\uDBFF])[\uDC00-\uDFFF]|[\uD800-\uDBFF]([^\uDC00-\uDFFF]|$)/g - -/** - * String to replace unmatched surrogate pair with. - * @private - */ - -var UNMATCHED_SURROGATE_PAIR_REPLACE = '$1\uFFFD$2' - -/** - * Encode a URL to a percent-encoded form, excluding already-encoded sequences. - * - * This function will take an already-encoded URL and encode all the non-URL - * code points. This function will not encode the "%" character unless it is - * not part of a valid sequence (`%20` will be left as-is, but `%foo` will - * be encoded as `%25foo`). - * - * This encode is meant to be "safe" and does not throw errors. It will try as - * hard as it can to properly encode the given URL, including replacing any raw, - * unpaired surrogate pairs with the Unicode replacement character prior to - * encoding. - * - * @param {string} url - * @return {string} - * @public - */ - -function encodeUrl (url) { - return String(url) - .replace(UNMATCHED_SURROGATE_PAIR_REGEXP, UNMATCHED_SURROGATE_PAIR_REPLACE) - .replace(ENCODE_CHARS_REGEXP, encodeURI) -} diff --git a/node_modules/encodeurl/package.json b/node_modules/encodeurl/package.json deleted file mode 100644 index b9f25ef..0000000 --- a/node_modules/encodeurl/package.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "name": "encodeurl", - "description": "Encode a URL to a percent-encoded form, excluding already-encoded sequences", - "version": "1.0.2", - "contributors": [ - "Douglas Christopher Wilson