Returns true if a number or string value is a finite number. Useful for regex matches, parsing, user input, etc.
The is-number npm package is a simple utility for checking if a value is a number. It works with various types of numeric representations, including strings that can be coerced to numbers, and provides a straightforward API for determining if a value can be considered a number in JavaScript.
Check if a value is a number
This feature allows you to check if a value is a number, including numeric strings.
const isNumber = require('is-number');
console.log(isNumber(5)); // true
console.log(isNumber('5')); // true
console.log(isNumber('five')); // falseCheck if a value is not a number
This feature allows you to check if a value is not a number, including strings that cannot be coerced to numbers and other non-numeric types.
const isNumber = require('is-number');
console.log(isNumber('foo')); // false
console.log(isNumber([1, 2, 3])); // falseCheck if a value is a finite number
This feature allows you to check if a value is a finite number, excluding Infinity, -Infinity, and NaN.
const isNumber = require('is-number');
console.log(isNumber(Infinity)); // false
console.log(isNumber(-Infinity)); // false
console.log(isNumber(NaN)); // falseThe isnumeric package offers similar functionality to is-number by checking if a value is numeric. It is similar in its simplicity and direct approach.
The numerable package is a more comprehensive library for number validation and formatting. It provides additional functionality compared to is-number, such as parsing and formatting numbers with localization support.
This package is part of the validate.io suite and checks if a value is a number primitive. It is more strict than is-number as it does not consider numeric strings to be numbers.
Returns true if the value is a finite number.
Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.
Install with npm:
$ npm install --save is-number
In JavaScript, it's not always as straightforward as it should be to reliably check if a value is a number. It's common for devs to use +, -, or Number() to cast a string value to a number (for example, when values are returned from user input, regex matches, parsers, etc). But there are many non-intuitive edge cases that yield unexpected results:
console.log(+[]); //=> 0
console.log(+''); //=> 0
console.log(+' '); //=> 0
console.log(typeof NaN); //=> 'number'
This library offers a performant way to smooth out edge cases like these.
const isNumber = require('is-number');
See the tests for more examples.
isNumber(5e3); // true
isNumber(0xff); // true
isNumber(-1.1); // true
isNumber(0); // true
isNumber(1); // true
isNumber(1.1); // true
isNumber(10); // true
isNumber(10.10); // true
isNumber(100); // true
isNumber('-1.1'); // true
isNumber('0'); // true
isNumber('012'); // true
isNumber('0xff'); // true
isNumber('1'); // true
isNumber('1.1'); // true
isNumber('10'); // true
isNumber('10.10'); // true
isNumber('100'); // true
isNumber('5e3'); // true
isNumber(parseInt('012')); // true
isNumber(parseFloat('012')); // true
Everything else is false, as you would expect:
isNumber(Infinity); // false
isNumber(NaN); // false
isNumber(null); // false
isNumber(undefined); // false
isNumber(''); // false
isNumber(' '); // false
isNumber('foo'); // false
isNumber([1]); // false
isNumber([]); // false
isNumber(function () {}); // false
isNumber({}); // false
.isFinite if it exists.Breaking changes
instanceof Number and instanceof StringAs with all benchmarks, take these with a grain of salt. See the benchmarks for more detail.
# all
v7.0 x 413,222 ops/sec ±2.02% (86 runs sampled)
v6.0 x 111,061 ops/sec ±1.29% (85 runs sampled)
parseFloat x 317,596 ops/sec ±1.36% (86 runs sampled)
fastest is 'v7.0'
# string
v7.0 x 3,054,496 ops/sec ±1.05% (89 runs sampled)
v6.0 x 2,957,781 ops/sec ±0.98% (88 runs sampled)
parseFloat x 3,071,060 ops/sec ±1.13% (88 runs sampled)
fastest is 'parseFloat,v7.0'
# number
v7.0 x 3,146,895 ops/sec ±0.89% (89 runs sampled)
v6.0 x 3,214,038 ops/sec ±1.07% (89 runs sampled)
parseFloat x 3,077,588 ops/sec ±1.07% (87 runs sampled)
fastest is 'v6.0'
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
You might also be interested in these projects:
Object constructor. | homepagetrue if the value is a primitive. | homepage| Commits | Contributor |
|---|---|
| 49 | jonschlinkert |
| 5 | charlike-old |
| 1 | benaadams |
| 1 | realityking |
Jon Schlinkert
Copyright © 2018, Jon Schlinkert. Released under the MIT License.
This file was generated by verb-generate-readme, v0.6.0, on June 15, 2018.
FAQs
Returns true if a number or string value is a finite number. Useful for regex matches, parsing, user input, etc.
The npm package is-number receives a total of 76,574,937 weekly downloads. As such, is-number popularity was classified as popular.
We found that is-number demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 10.12.1 introduces a global virtual store for faster installs and new options for managing dependencies with version catalogs.
Security News
Amaro 1.0 lays the groundwork for stable TypeScript support in Node.js, bringing official .ts loading closer to reality.
Research
A deceptive PyPI package posing as an Instagram growth tool collects user credentials and sends them to third-party bot services.