1949

I'm hoping there's something in the same conceptual space as the old VB6 IsNumeric() function?

8
  • 5
    See this related question, which I asked some time ago. Oct 6, 2008 at 19:17
  • 55
    If you go to this question, try to skip past all the RegEx answers. That's just NOT the way to do it. Oct 6, 2008 at 19:20
  • 18
    Unless one wants to do exactly that: To check whether a given string has a format of a valid stream of digits. Why should it be wrong then?
    – SasQ
    May 18, 2014 at 23:53
  • 43
    The selected answer is incorrect!!! See its comments, but basically it fails with e.g. isNaN(""), isNaN(" "), isNaN(false), etc. It returns false for these, implying that they are numbers.
    – Andrew
    Oct 5, 2017 at 20:42
  • 13
    so the selected answer is incorrect, regexp is not the way to do that neither. Which one is correct then?
    – vir us
    May 9, 2020 at 8:10

56 Answers 56

3212

2nd October 2020: note that many bare-bones approaches are fraught with subtle bugs (eg. whitespace, implicit partial parsing, radix, coercion of arrays etc.) that many of the answers here fail to take into account. The following implementation might work for you, but note that it does not cater for number separators other than the decimal point ".":

function isNumeric(str) {
  if (typeof str != "string") return false // we only process strings!  
  return !isNaN(str) && // use type coercion to parse the _entirety_ of the string (`parseFloat` alone does not do this)...
         !isNaN(parseFloat(str)) // ...and ensure strings of whitespace fail
}

To check if a variable (including a string) is a number, check if it is not a number:

This works regardless of whether the variable content is a string or number.

isNaN(num)         // returns true if the variable does NOT contain a valid number

Examples

isNaN(123)         // false
isNaN('123')       // false
isNaN('1e10000')   // false (This translates to Infinity, which is a number)
isNaN('foo')       // true
isNaN('10px')      // true
isNaN('')          // false
isNaN(' ')         // false
isNaN(false)       // false

Of course, you can negate this if you need to. For example, to implement the IsNumeric example you gave:

function isNumeric(num){
  return !isNaN(num)
}

To convert a string containing a number into a number:

Only works if the string only contains numeric characters, else it returns NaN.

+num               // returns the numeric value of the string, or NaN 
                   // if the string isn't purely numeric characters

Examples

+'12'              // 12
+'12.'             // 12
+'12..'            // NaN
+'.12'             // 0.12
+'..12'            // NaN
+'foo'             // NaN
+'12px'            // NaN

To convert a string loosely to a number

Useful for converting '12px' to 12, for example:

parseInt(num)      // extracts a numeric value from the 
                   // start of the string, or NaN.

Examples

parseInt('12')     // 12
parseInt('aaa')    // NaN
parseInt('12px')   // 12
parseInt('foo2')   // NaN      These last three may
parseInt('12a5')   // 12       be different from what
parseInt('0x10')   // 16       you expected to see.

Floats

Bear in mind that, unlike +num, parseInt (as the name suggests) will convert a float into an integer by chopping off everything following the decimal point (if you want to use parseInt() because of this behaviour, you're probably better off using another method instead):

+'12.345'          // 12.345
parseInt(12.345)   // 12
parseInt('12.345') // 12

Empty strings

Empty strings may be a little counter-intuitive. +num converts empty strings or strings with spaces to zero, and isNaN() assumes the same:

+''                // 0
+'   '             // 0
isNaN('')          // false
isNaN('   ')       // false

But parseInt() does not agree:

parseInt('')       // NaN
parseInt('   ')    // NaN
33
  • 179
    A very important note about parseInt is that it will allow you to specify a radix for converting the string to an int. This is a big gotcha as it tries to guess a radix for you if you don't supply it. So, for example: parseInt("17") results in 17 (decimal, 10), but parseInt("08") results in 0 (octal, 8). So, unless you intend otherwise, it is safest to use parseInt(number, 10), specifying 10 as the radix explicitly.
    – Adam Raney
    Apr 28, 2009 at 22:48
  • 49
    Note that !isNaN(undefined) returns false. Nov 6, 2010 at 5:34
  • 174
    This is just plain wrong - how did it get so many upvotes? You cannot use isNaN "To check to see if a variable is not a number". "not a number" is not the same as "IEEE-794 NaN", which is what isNaN tests for. In particular, this usage fails when testing booleans and empty strings, at least. See developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/….
    – EML
    Dec 30, 2013 at 0:33
  • 72
    The fastest possible way to check if something is a number is the "equal to self" check: var n = 'a'; if (+n === +n) { // is number } It is ~3994% faster than isNaN in the latest version of Chrome. See the performance test here: jsperf.com/isnan-vs-typeof/5 Jan 22, 2014 at 0:59
  • 32
    ** Warning ** This answer is wrong. Use at your own risk. Example: isNaN(1 + false + parseInt("1.do you trust your users?")) May 31, 2017 at 14:50
209

If you're just trying to check if a string is a whole number (no decimal places), regex is a good way to go. Other methods such as isNaN are too complicated for something so simple.

function isNumeric(value) {
    return /^-?\d+$/.test(value);
}

console.log(isNumeric('abcd'));         // false
console.log(isNumeric('123a'));         // false
console.log(isNumeric('1'));            // true
console.log(isNumeric('1234567890'));   // true
console.log(isNumeric('-23'));          // true
console.log(isNumeric(1234));           // true
console.log(isNumeric(1234n));          // true
console.log(isNumeric('123.4'));        // false
console.log(isNumeric(''));             // false
console.log(isNumeric(undefined));      // false
console.log(isNumeric(null));           // false

To only allow positive whole numbers use this:

function isNumeric(value) {
    return /^\d+$/.test(value);
}

console.log(isNumeric('123'));          // true
console.log(isNumeric('-23'));          // false
14
  • 15
    console.log(isNumeric('-1'));
    – yongnan
    Nov 13, 2014 at 1:02
  • 8
    console.log(isNumeric('2e2')); Mar 2, 2015 at 15:27
  • 35
    Perhaps just rename "isNumeric" to "hasOnlyDigits". in many cases, that is exactly the check you are looking for.
    – gus3001
    Oct 9, 2017 at 20:39
  • 2
    This is what I was looking for, the equivalent to php ctype_digit Sep 20, 2019 at 11:17
  • 8
    Slightly better.. disallow numeric characters from languages like arabic /^[0-9]+$/.test(value) Oct 19, 2020 at 18:53
92

The accepted answer for this question has quite a few flaws (as highlighted by couple of other users). This is one of the easiest & proven way to approach it in javascript:

function isNumeric(n) {
  return !isNaN(parseFloat(n)) && isFinite(n);
}

Below are some good test cases:

console.log(isNumeric(12345678912345678912)); // true
console.log(isNumeric('2 '));                 // true
console.log(isNumeric('-32.2 '));             // true
console.log(isNumeric(-32.2));                // true
console.log(isNumeric(undefined));            // false

// the accepted answer fails at these tests:
console.log(isNumeric(''));                   // false
console.log(isNumeric(null));                 // false
console.log(isNumeric([]));                   // false
6
  • 8
    parseFloat is insufficient for this application because it will return a valid number parsed so far, when it encounters the first character that cannot be parsed as a number. eg. parseFloat('1.1ea10') === 1.1.
    – Ben Aston
    Oct 2, 2020 at 10:35
  • 2
    beware, if you use Number.isNan and Number.isFinite, this will not work. Jul 2, 2021 at 13:54
  • For strings Number.isNaN and Number.isFinite won't work because they won't cast string to number.
    – Cas
    Jul 27, 2021 at 8:49
  • how about 10,1? Oct 30, 2022 at 11:38
  • this will not work with an array input isNumeric([2]). an Arraytype is not numeric
    – dazzafact
    Mar 27, 2023 at 6:28
79

And you could go the RegExp-way:

var num = "987238";

if(num.match(/^-?\d+$/)){
  //valid integer (positive or negative)
}else if(num.match(/^\d+\.\d+$/)){
  //valid float
}else{
  //not valid number
}
9
  • 55
    In this case, RegExp == bad Oct 6, 2008 at 19:27
  • 11
    This fails on hexadecimal numbers (0x12, for example), floats without a leading zero (.42, for example) and negative numbers.
    – Ori
    Apr 18, 2012 at 1:25
  • 25
    @JoelCoehoorn Care to elaborate on why RegExp == bad here? Seems to be a valid use case to me.
    – computrius
    Dec 30, 2014 at 16:02
  • 7
    There are more ways than it seems to build a number (hex numbers in another comment are just one example), and there are many numbers that may not be considered valid (overflow the type, too precise, etc). Also, regex is both slower and more complicated than just using the built-in mechanisms Dec 30, 2014 at 18:18
  • 2
    should also match scientific notation... 1e10 etc. Oct 30, 2017 at 21:45
55

If you really want to make sure that a string contains only a number, any number (integer or floating point), and exactly a number, you cannot use parseInt()/ parseFloat(), Number(), or !isNaN() by themselves. Note that !isNaN() is actually returning true when Number() would return a number, and false when it would return NaN, so I will exclude it from the rest of the discussion.

The problem with parseFloat() is that it will return a number if the string contains any number, even if the string doesn't contain only and exactly a number:

parseFloat("2016-12-31")  // returns 2016
parseFloat("1-1") // return 1
parseFloat("1.2.3") // returns 1.2

The problem with Number() is that it will return a number in cases where the passed value is not a number at all!

Number("") // returns 0
Number(" ") // returns 0
Number(" \u00A0   \t\n\r") // returns 0

The problem with rolling your own regex is that unless you create the exact regex for matching a floating point number as Javascript recognizes it you are going to miss cases or recognize cases where you shouldn't. And even if you can roll your own regex, why? There are simpler built-in ways to do it.

However, it turns out that Number() (and isNaN()) does the right thing for every case where parseFloat() returns a number when it shouldn't, and vice versa. So to find out if a string is really exactly and only a number, call both functions and see if they both return true:

function isNumber(str) {
  if (typeof str != "string") return false // we only process strings!
  // could also coerce to string: str = ""+str
  return !isNaN(str) && !isNaN(parseFloat(str))
}
5
  • 2
    This returns true when the string has leading or trailing spaces. ' 1', '2 ' and ' 3 ' all return true.
    – Rudey
    Feb 22, 2017 at 20:07
  • Adding something like this to the return-statement would solve that: && !/^\s+|\s+$/g.test(str) May 15, 2017 at 13:07
  • 2
    @RuudLenders - most people won't care if there are trailing spaces that get lopped off to make the string a valid number, because its easy to accidentally put in the extra spaces in lots of interfaces.
    – Ian
    Nov 3, 2017 at 19:34
  • 9
    That's true in case the number string is coming from user input. But I thought I should mention spaces anyway, because I think most people who need an isNumber function aren't dealing with user interfaces. Also, a good number input won't allow spaces to begin with.
    – Rudey
    Nov 4, 2017 at 21:25
  • 1
    @Michael Thank you very much for this post. I found it tremendously helpful as I wade my way into JavaScript. In the academic arena, not a practical concern, the string "Infinity" is returned as a number (true) by the above function which makes sense because Infinity is a number in Javascript :-). Both the Numeric() and parseFloat convert the string to Infinity. Thanks, peace. May 20, 2023 at 14:46
42

2019: Including ES3, ES6 and TypeScript Examples

Maybe this has been rehashed too many times, however I fought with this one today too and wanted to post my answer, as I didn't see any other answer that does it as simply or thoroughly:

ES3

var isNumeric = function(num){
    return (typeof(num) === 'number' || typeof(num) === "string" && num.trim() !== '') && !isNaN(num);  
}

ES6

const isNumeric = (num) => (typeof(num) === 'number' || typeof(num) === "string" && num.trim() !== '') && !isNaN(num);

Typescript

const isNumeric = (num: any) => (typeof(num) === 'number' || typeof(num) === "string" && num.trim() !== '') && !isNaN(num as number);

This seems quite simple and covers all the bases I saw on the many other posts and thought up myself:

// Positive Cases
console.log(0, isNumeric(0) === true);
console.log(1, isNumeric(1) === true);
console.log(1234567890, isNumeric(1234567890) === true);
console.log('1234567890', isNumeric('1234567890') === true);
console.log('0', isNumeric('0') === true);
console.log('1', isNumeric('1') === true);
console.log('1.1', isNumeric('1.1') === true);
console.log('-1', isNumeric('-1') === true);
console.log('-1.2354', isNumeric('-1.2354') === true);
console.log('-1234567890', isNumeric('-1234567890') === true);
console.log(-1, isNumeric(-1) === true);
console.log(-32.1, isNumeric(-32.1) === true);
console.log('0x1', isNumeric('0x1') === true);  // Valid number in hex
// Negative Cases
console.log(true, isNumeric(true) === false);
console.log(false, isNumeric(false) === false);
console.log('1..1', isNumeric('1..1') === false);
console.log('1,1', isNumeric('1,1') === false);
console.log('-32.1.12', isNumeric('-32.1.12') === false);
console.log('[blank]', isNumeric('') === false);
console.log('[spaces]', isNumeric('   ') === false);
console.log('null', isNumeric(null) === false);
console.log('undefined', isNumeric(undefined) === false);
console.log([], isNumeric([]) === false);
console.log('NaN', isNumeric(NaN) === false);

You can also try your own isNumeric function and just past in these use cases and scan for "true" for all of them.

Or, to see the values that each return:

Results of each test against <code>isNumeric()</code>

6
  • 1
    good, except for example for '0x10' (returns true!) Mar 8, 2021 at 18:45
  • 1
    @S.Serpooshan, 0x10 should return true, it is a hex number. 0x1 is shown in the test cases and and is expected to return true, it is a number. If your specific use case requires that hex numbers be treated as a string then you will need to write the solution a little differently.
    – Jeremy
    Apr 26, 2021 at 21:39
  • Yes, it depends on our scenario Apr 29, 2021 at 10:22
  • 2
    Also works with scientific notation: isNumeric('3e2') / isNumeric(3e2)
    – Kieran101
    Aug 23, 2022 at 1:00
  • 4
    The type for the typescript version should be unknown: const isNumeric = (num: unknown)
    – Milan
    Feb 24, 2023 at 12:53
35
+200

TL;DR

It depends largely on what you want to parse as a number.

Comparison Between Built-in Functions

As none of the existing sources satisfied my soul, I tried to figure out what actually was happening with these functions.

Three immediate answers to this question felt like:

  1. !isNaN(input) (which gives the same output as +input === +input)
  2. !isNaN(parseFloat(input))
  3. isFinite(input)

But are any of them correct in every scenario?

I tested these functions in several cases, and generated output as markdown. This is what it looks like:

input !isNaN(input) or
+input===+input
!isNaN(
parseFloat(
input))
isFinite(
input)
Comment
123 ✔️ ✔️ ✔️ -
'123' ✔️ ✔️ ✔️ -
12.3 ✔️ ✔️ ✔️ -
'12.3' ✔️ ✔️ ✔️ -
'   12.3   ' ✔️ ✔️ ✔️ Empty whitespace trimmed, as expected.
1_000_000 ✔️ ✔️ ✔️ Numeric separator understood, also expected.
'1_000_000' ✔️ Surprise! JS just won't parse numeric separator inside a string. For details, check this issue. (Why then parsing as float worked though? Well, it didn't. 😉)
'0b11111111' ✔️ ✔️ ✔️ Binary form understood, as it should've.
'0o377' ✔️ ✔️ ✔️ Octal form understood too.
'0xFF' ✔️ ✔️ ✔️ Of course hex is understood. Did anybody think otherwise? 😒
'' ✔️ ✔️ Should empty string be a number?
'    ' ✔️ ✔️ Should a whitespace-only string be a number?
'abc' Everybody agrees, not a number.
'12.34Ab!@#$' ✔️ Ah! Now it's quite understandable what parseFloat() does. Not impressive to me, but may come handy in certain cases.
'10e100' ✔️ ✔️ ✔️ 10100 is a number indeed.
But caution! It's way more larger than the maximum safe integer value 253 (about 9×1015). Read this for details.
'10e1000' ✔️ ✔️ Say with me, help!
Though not as crazy as it may seem. In JavaScript, a value larger than ~10308 is rounded to infinity, that's why. Look here for details.
And yes, isNaN() considers infinity as a number, and parseFloat() parses infinity as infinity.
null ✔️ ✔️ Now this is awkward. In JS, when a conversion is needed, null becomes zero, and we get a finite number.
Then why parseFloat(null) should return a NaN here? Someone please explain this design concept to me.
undefined As expected.
Infinity ✔️ ✔️ As explained before, isNaN() considers infinity as a number, and parseFloat() parses infinity as infinity.

So...which of them is "correct"?

Should be clear by now, it depends largely on what we need. For example, we may want to consider a null input as 0. In that case isFinite() will work fine.

Again, perhaps we will take a little help from isNaN() when 1010000000000 is needed to be considered a valid number (although the question remains—why would it be, and how would we handle that)!

Of course, we can manually exclude any of the scenarios.

Like in my case, I needed exactly the outputs of isFinite(), except for the null case, the empty string case, and the whitespace-only string case. Also I had no headache about really huge numbers. So my code looked like this:

/**
 * My necessity was met by the following code.
 */

if (input === null) {
    // Null input
} else if (input.trim() === '') {
    // Empty or whitespace-only string
} else if (isFinite(input)) {
    // Input is a number
} else {
    // Not a number
}

And also, this was my JavaScript to generate the table:

/**
 * Note: JavaScript does not print numeric separator inside a number.
 * In that single case, the markdown output was manually corrected.
 * Also, the comments were manually added later, of course.
 */

let inputs = [
    123, '123', 12.3, '12.3', '   12.3   ',
    1_000_000, '1_000_000',
    '0b11111111', '0o377', '0xFF',
    '', '    ',
    'abc', '12.34Ab!@#$',
    '10e100', '10e1000',
    null, undefined, Infinity];

let markdownOutput = `| \`input\` | \`!isNaN(input)\` or <br>\`+input === +input\` | \`!isNaN(parseFloat(input))\` | \`isFinite(input)\` | Comment |
| :---: | :---: | :---: | :---: | :--- |\n`;

for (let input of inputs) {
    let outputs = [];
    outputs.push(!isNaN(input));
    outputs.push(!isNaN(parseFloat(input)));
    outputs.push(isFinite(input));

    if (typeof input === 'string') {
        // Output with quotations
        console.log(`'${input}'`);
        markdownOutput += `| '${input}'`;
    } else {
        // Output without quotes
        console.log(input);
        markdownOutput += `| ${input}`;
    }

    for (let output of outputs) {
        console.log('\t' + output);
        if (output === true) {
            markdownOutput += ` | <div style="color:limegreen">true</div>`;
            // markdownOutput += ` | ✔️`; // for stackoverflow
        } else {
            markdownOutput += ` | <div style="color:orangered">false</div>`;
            // markdownOutput += ` | ❌`; // for stackoverflow
        }
    }

    markdownOutput += ` ||\n`;
}

// Replace two or more whitespaces with $nbsp;
markdownOutput = markdownOutput.replaceAll(`  `, `&nbsp;&nbsp;`);

// Print markdown to console
console.log(markdownOutput);
3
  • 1
    And a more rigorous solution
    – ooo
    Dec 26, 2022 at 3:28
  • Excellent answer. Kudos.
    – Brad
    Mar 16, 2023 at 6:46
  • '0123' A string which is expected to remain a string but any of these technique detect a number and will result in the 0 being lost.
    – MrYellow
    Apr 19, 2023 at 3:57
31

Try the isNan function:

The isNaN() function determines whether a value is an illegal number (Not-a-Number).

This function returns true if the value equates to NaN. Otherwise it returns false.

This function is different from the Number specific Number.isNaN() method.

  The global isNaN() function, converts the tested value to a Number, then tests it.

Number.isNan() does not convert the values to a Number, and will not return true for any value that is not of the type Number...

5
  • 4
    Make sure you add a check for the empty string. isNaN('') returns false but you probably want it to return true in this case. Oct 6, 2008 at 19:44
  • 3
    isFinite is a better check - it deals with the wierd corner case of Infinity
    – JonnyRaa
    Jan 20, 2015 at 12:02
  • 4
    @MichaelHaren Not good enough! isNaN() returns false for ANY string containing only whitespace characters, including things like '\u00A0'.
    – Michael
    Mar 2, 2016 at 22:13
  • 5
    WARNING: Does not work for the values: null, "" (empty string) and false. Jul 27, 2017 at 8:02
  • I realize this answer was given 11 years ago and a few minutes before the accepted one, but like it or not, the accepted answer has WAY more conversation around it, so this answer doesn't really add anything to answering the question. I would kindly suggest deleting it, to avoid distracting new readers. I also think you'll get the Disciplined badge if you do that. Oct 6, 2019 at 6:15
28

The JavaScript global isFinite() checks if a value is a valid (finite) number.

See MDN for the difference between Number.isFinite() and global isFinite().

let a = isFinite('abc') // false
let b = isFinite('123') // true
let c = isFinite('12a') // false
let d = isFinite(null)  // true
console.log(a, b, c, d)

3
  • 9
    isFinite(null) returns true!
    – Harry
    Oct 8, 2022 at 5:49
  • 1
    @Harry, according to Mozilla Docs, using Number.isFinite(null) would be more robust and would return false. Downside is if you want to accept '0' as this would also return false. Seems best to first reject null and then use isFinite if one wants to use this.
    – danefondo
    Nov 13, 2022 at 12:48
  • 1
    Also take care isFinite([]) and isFinite('') returns true
    – Alice Chan
    Apr 24, 2023 at 6:30
19

Old question, but there are several points missing in the given answers.

Scientific notation.

!isNaN('1e+30') is true, however in most of the cases when people ask for numbers, they do not want to match things like 1e+30.

Large floating numbers may behave weird

Observe (using Node.js):

> var s = Array(16 + 1).join('9')
undefined
> s.length
16
> s
'9999999999999999'
> !isNaN(s)
true
> Number(s)
10000000000000000
> String(Number(s)) === s
false
>

On the other hand:

> var s = Array(16 + 1).join('1')
undefined
> String(Number(s)) === s
true
> var s = Array(15 + 1).join('9')
undefined
> String(Number(s)) === s
true
>

So, if one expects String(Number(s)) === s, then better limit your strings to 15 digits at most (after omitting leading zeros).

Infinity

> typeof Infinity
'number'
> !isNaN('Infinity')
true
> isFinite('Infinity')
false
>

Given all that, checking that the given string is a number satisfying all of the following:

  • non scientific notation
  • predictable conversion to Number and back to String
  • finite

is not such an easy task. Here is a simple version:

  function isNonScientificNumberString(o) {
    if (!o || typeof o !== 'string') {
      // Should not be given anything but strings.
      return false;
    }
    return o.length <= 15 && o.indexOf('e+') < 0 && o.indexOf('E+') < 0 && !isNaN(o) && isFinite(o);
  }

However, even this one is far from complete. Leading zeros are not handled here, but they do screw the length test.

1
  • 2
    "however in most of the cases when people ask for numbers, they do not want to match things like 1e+30" Why would you say this? If someone wants to know if a string contains a number, it seems to me that they would want to know if it contains a number, and 1e+30 is a number. Certainly if I were testing a string for a numeric value in JavaScript, I would want that to match.
    – Dan Jones
    Jan 4, 2017 at 17:42
18

Someone may also benefit from a regex based answer. Here it is:

One liner isInteger:

const isInteger = num => /^-?[0-9]+$/.test(num+'');

One liner isNumeric: Accepts integers and decimals

const isNumeric = num => /^-?[0-9]+(?:\.[0-9]+)?$/.test(num+'');
4
  • This has the issue of considering whitespace to be an invalid character, if that's not what you want then rather use const isInteger = num => /^\s*-?[0-9]+\s*$/.test(num+''); or const isNumeric = num => /^\s*-?[0-9]+(?:\.[0-9]+)\s*?$/.test(num+'');
    – yoel halb
    Apr 6, 2022 at 21:09
  • 2
    @yoelhalb Whitespace is an invalid character for a number. You can trim the string before you pass it in.
    – chickens
    Apr 7, 2022 at 12:40
  • empty string isn't a number. But i guess that's true ;)
    – windmaomao
    Oct 12, 2022 at 13:25
  • This also doesn't account for other ways to format numbers, e.g., hex numbers and scientific notation.
    – R. Agnese
    Apr 27, 2023 at 14:42
17

I have tested and Michael's solution is best. Vote for his answer above (search this page for "If you really want to make sure that a string" to find it). In essence, his answer is this:

function isNumeric(num){
  num = "" + num; //coerce num to be a string
  return !isNaN(num) && !isNaN(parseFloat(num));
}

It works for every test case, which I documented here: https://jsfiddle.net/wggehvp9/5/

Many of the other solutions fail for these edge cases: ' ', null, "", true, and []. In theory, you could use them, with proper error handling, for example:

return !isNaN(num);

or

return (+num === +num);

with special handling for /\s/, null, "", true, false, [] (and others?)

2
  • 1
    This still returns true with trailing/leading spaces. Adding something like this to the return-statement would solve that: && !/^\s+|\s+$/g.test(str) May 15, 2017 at 13:13
  • 2
    So ' 123' should be false, not a number, while '1234' should be a number? I like how it is, so that " 123" is a number, but that may be up to the discretion of the developer if leading or trailing spaces should change the value.
    – JohnP2
    Jun 14, 2017 at 19:10
13

You can use the result of Number when passing an argument to its constructor.

If the argument (a string) cannot be converted into a number, it returns NaN, so you can determinate if the string provided was a valid number or not.

Notes: Note when passing empty string or '\t\t' and '\n\t' as Number will return 0; Passing true will return 1 and false returns 0.

    Number('34.00') // 34
    Number('-34') // -34
    Number('123e5') // 12300000
    Number('123e-5') // 0.00123
    Number('999999999999') // 999999999999
    Number('9999999999999999') // 10000000000000000 (integer accuracy up to 15 digit)
    Number('0xFF') // 255
    Number('Infinity') // Infinity  

    Number('34px') // NaN
    Number('xyz') // NaN
    Number('true') // NaN
    Number('false') // NaN

    // cavets
    Number('    ') // 0
    Number('\t\t') // 0
    Number('\n\t') // 0
2
  • The Number constructor is exactly the same as +x.
    – GregRos
    Dec 28, 2018 at 21:56
  • As a side note, keep in mind that the ES6 Number() handles float numbers as well, like Number.parseFloat() not Number.parseInt()
    – zurfyx
    Jan 20, 2020 at 20:27
11

Maybe there are one or two people coming across this question who need a much stricter check than usual (like I did). In that case, this might be useful:

if(str === String(Number(str))) {
  // it's a "perfectly formatted" number
}

Beware! This will reject strings like .1, 40.000, 080, 00.1. It's very picky - the string must match the "most minimal perfect form" of the number for this test to pass.

It uses the String and Number constructor to cast the string to a number and back again and thus checks if the JavaScript engine's "perfect minimal form" (the one it got converted to with the initial Number constructor) matches the original string.

4
  • 2
    Thanks @JoeRocc. I needed this too, but just for integers, so I added: (str === String(Math.round(Number(str)))). May 31, 2017 at 14:43
  • Be aware that "Infinity", "-Infinity", and "NaN" pass this test. However, this can be fixed using an additional Number.isFinite test.
    – GregRos
    Dec 28, 2018 at 21:53
  • 1
    This is exactly the same as str === ("" + +str). It basically checks whether the string is the result of stringifying a JS number. Knowing this, we can also see a problem: the test passes for 0.000001 but fails for 0.0000001, which is when 1e-7 passes instead. The same for very big numbers.
    – GregRos
    Dec 28, 2018 at 22:19
  • This answer is incorrect. 1e10 is "perfectly valid and formatted", and yet fails this algorithm.
    – Ben Aston
    Oct 2, 2020 at 10:52
8

Why is jQuery's implementation not good enough?

function isNumeric(a) {
    var b = a && a.toString();
    return !$.isArray(a) && b - parseFloat(b) + 1 >= 0;
};

Michael suggested something like this (although I've stolen "user1691651 - John"'s altered version here):

function isNumeric(num){
    num = "" + num; //coerce num to be a string
    return !isNaN(num) && !isNaN(parseFloat(num));
}

The following is a solution with most likely bad performance, but solid results. It is a contraption made from the jQuery 1.12.4 implementation and Michael's answer, with an extra check for leading/trailing spaces (because Michael's version returns true for numerics with leading/trailing spaces):

function isNumeric(a) {
    var str = a + "";
    var b = a && a.toString();
    return !$.isArray(a) && b - parseFloat(b) + 1 >= 0 &&
           !/^\s+|\s+$/g.test(str) &&
           !isNaN(str) && !isNaN(parseFloat(str));
};

The latter version has two new variables, though. One could get around one of those, by doing:

function isNumeric(a) {
    if ($.isArray(a)) return false;
    var b = a && a.toString();
    a = a + "";
    return b - parseFloat(b) + 1 >= 0 &&
            !/^\s+|\s+$/g.test(a) &&
            !isNaN(a) && !isNaN(parseFloat(a));
};

I haven't tested any of these very much, by other means than manually testing the few use-cases I'll be hitting with my current predicament, which is all very standard stuff. This is a "standing-on-the-shoulders-of-giants" situation.

8

2019: Practical and tight numerical validity check

Often, a 'valid number' means a Javascript number excluding NaN and Infinity, ie a 'finite number'.

To check the numerical validity of a value (from an external source for example), you can define in ESlint Airbnb style :

/**
 * Returns true if 'candidate' is a finite number or a string referring (not just 'including') a finite number
 * To keep in mind:
 *   Number(true) = 1
 *   Number('') = 0
 *   Number("   10  ") = 10
 *   !isNaN(true) = true
 *   parseFloat('10 a') = 10
 *
 * @param {?} candidate
 * @return {boolean}
 */
function isReferringFiniteNumber(candidate) {
  if (typeof (candidate) === 'number') return Number.isFinite(candidate);
  if (typeof (candidate) === 'string') {
    return (candidate.trim() !== '') && Number.isFinite(Number(candidate));
  }
  return false;
}

and use it this way:

if (isReferringFiniteNumber(theirValue)) {
  myCheckedValue = Number(theirValue);
} else {
  console.warn('The provided value doesn\'t refer to a finite number');
}
0
8

I like the simplicity of this.

Number.isNaN(Number(value))

The above is regular Javascript, but I'm using this in conjunction with a typescript typeguard for smart type checking. This is very useful for the typescript compiler to give you correct intellisense, and no type errors.

Typescript typeguards

Warning: See Jeremy's comment below. This has some issues with certain values and I don't have time to fix it now, but the idea of using a typescript typeguard is useful so I won't delete this section.

isNotNumber(value: string | number): value is string {
    return Number.isNaN(Number(this.smartImageWidth));
}
isNumber(value: string | number): value is number {
    return Number.isNaN(Number(this.smartImageWidth)) === false;
}

Let's say you have a property width which is number | string. You may want to do logic based on whether or not it's a string.

var width: number|string;
width = "100vw";

if (isNotNumber(width)) 
{
    // the compiler knows that width here must be a string
    if (width.endsWith('vw')) 
    {
        // we have a 'width' such as 100vw
    } 
}
else 
{
    // the compiler is smart and knows width here must be number
    var doubleWidth = width * 2;    
}

The typeguard is smart enough to constrain the type of width within the if statement to be ONLY string. This permits the compiler to allow width.endsWith(...) which it wouldn't allow if the type was string | number.

You can call the typeguard whatever you want isNotNumber, isNumber, isString, isNotString but I think isString is kind of ambiguous and harder to read.

2
  • 2
    Works relatively well in plain JS, but fails cases like 1..1, 1,1, -32.1.12, and more importantly fails undefined and NaN. Not sure if your TS makes up for it, but it looks like if you passed undefined or a NaN that it would fail trying to do undefined * 2, which won't crash but will return NaN.
    – Jeremy
    Oct 25, 2019 at 22:02
  • Note that this approach allows an e or E in the number (for instance 2E34) as it is considered a valid number (the "scientific notation"), but is not necessarily what you want...
    – yoel halb
    Apr 6, 2022 at 20:56
7

It is not valid for TypeScript as:

declare function isNaN(number: number): boolean;

For TypeScript you can use:

/^\d+$/.test(key)

1
  • /^\d+$/.test("-1") // false To use isNaN with non-numbers in TS, you can just cast the value to any, or use one of the other more comprehensive solutions here that make use of Number, parseFloat, etc. Jul 13, 2020 at 17:51
6

parseInt(), but be aware that this function is a bit different in the sense that it for example returns 100 for parseInt("100px").

3
  • And 11 for parseInt(09).
    – djechlin
    Jun 25, 2013 at 22:43
  • 12
    because you need to use paraseInt(09, 10)
    – Gavin
    Jun 27, 2014 at 17:21
  • 2
    As of ECMAScript 5, which has wide browser support (IE≥9), you don't need the , 10 argument any more. parseInt('09') now equals 9. Oct 2, 2017 at 19:48
6

Quote:

isNaN(num) // returns true if the variable does NOT contain a valid number

is not entirely true if you need to check for leading/trailing spaces - for example when a certain quantity of digits is required, and you need to get, say, '1111' and not ' 111' or '111 ' for perhaps a PIN input.

Better to use:

var num = /^\d+$/.test(num)
1
  • The values '-1', '0.1' and '1e10' all return false. Furthermore, values larger than positive infinity or smaller than negative infinity return true, while they probably should return false.
    – Rudey
    Feb 22, 2017 at 20:11
6

When guarding against empty strings and null

// Base cases that are handled properly
Number.isNaN(Number('1')); // => false
Number.isNaN(Number('-1')); // => false
Number.isNaN(Number('1.1')); // => false
Number.isNaN(Number('-1.1')); // => false
Number.isNaN(Number('asdf')); // => true
Number.isNaN(Number(undefined)); // => true

// Special notation cases that are handled properly
Number.isNaN(Number('1e1')); // => false
Number.isNaN(Number('1e-1')); // => false
Number.isNaN(Number('-1e1')); // => false
Number.isNaN(Number('-1e-1')); // => false
Number.isNaN(Number('0b1')); // => false
Number.isNaN(Number('0o1')); // => false
Number.isNaN(Number('0xa')); // => false

// Edge cases that will FAIL if not guarded against
Number.isNaN(Number('')); // => false
Number.isNaN(Number(' ')); // => false
Number.isNaN(Number(null)); // => false

// Edge cases that are debatable
Number.isNaN(Number('-0b1')); // => true
Number.isNaN(Number('-0o1')); // => true
Number.isNaN(Number('-0xa')); // => true
Number.isNaN(Number('Infinity')); // => false 
Number.isNaN(Number('INFINITY')); // => true  
Number.isNaN(Number('-Infinity')); // => false 
Number.isNaN(Number('-INFINITY')); // => true  

When NOT guarding against empty strings and null

Using parseInt:

// Base cases that are handled properly
Number.isNaN(parseInt('1')); // => false
Number.isNaN(parseInt('-1')); // => false
Number.isNaN(parseInt('1.1')); // => false
Number.isNaN(parseInt('-1.1')); // => false
Number.isNaN(parseInt('asdf')); // => true
Number.isNaN(parseInt(undefined)); // => true
Number.isNaN(parseInt('')); // => true
Number.isNaN(parseInt(' ')); // => true
Number.isNaN(parseInt(null)); // => true

// Special notation cases that are handled properly
Number.isNaN(parseInt('1e1')); // => false
Number.isNaN(parseInt('1e-1')); // => false
Number.isNaN(parseInt('-1e1')); // => false
Number.isNaN(parseInt('-1e-1')); // => false
Number.isNaN(parseInt('0b1')); // => false
Number.isNaN(parseInt('0o1')); // => false
Number.isNaN(parseInt('0xa')); // => false

// Edge cases that are debatable
Number.isNaN(parseInt('-0b1')); // => false
Number.isNaN(parseInt('-0o1')); // => false
Number.isNaN(parseInt('-0xa')); // => false
Number.isNaN(parseInt('Infinity')); // => true 
Number.isNaN(parseInt('INFINITY')); // => true  
Number.isNaN(parseInt('-Infinity')); // => true 
Number.isNaN(parseInt('-INFINITY')); // => true 

Using parseFloat:

// Base cases that are handled properly
Number.isNaN(parseFloat('1')); // => false
Number.isNaN(parseFloat('-1')); // => false
Number.isNaN(parseFloat('1.1')); // => false
Number.isNaN(parseFloat('-1.1')); // => false
Number.isNaN(parseFloat('asdf')); // => true
Number.isNaN(parseFloat(undefined)); // => true
Number.isNaN(parseFloat('')); // => true
Number.isNaN(parseFloat(' ')); // => true
Number.isNaN(parseFloat(null)); // => true

// Special notation cases that are handled properly
Number.isNaN(parseFloat('1e1')); // => false
Number.isNaN(parseFloat('1e-1')); // => false
Number.isNaN(parseFloat('-1e1')); // => false
Number.isNaN(parseFloat('-1e-1')); // => false
Number.isNaN(parseFloat('0b1')); // => false
Number.isNaN(parseFloat('0o1')); // => false
Number.isNaN(parseFloat('0xa')); // => false

// Edge cases that are debatable
Number.isNaN(parseFloat('-0b1')); // => false
Number.isNaN(parseFloat('-0o1')); // => false
Number.isNaN(parseFloat('-0xa')); // => false
Number.isNaN(parseFloat('Infinity')); // => false 
Number.isNaN(parseFloat('INFINITY')); // => true  
Number.isNaN(parseFloat('-Infinity')); // => false 
Number.isNaN(parseFloat('-INFINITY')); // => true

Notes:

  • Only string, empty, and uninitialized values are considered in keeping with addressing the original question. Additional edge cases exist if arrays and objects are the values being considered.
  • Characters in binary, octal, hexadecimal, and exponential notation are not case-sensitive (ie: '0xFF', '0XFF', '0xfF' etc. will all yield the same result in the test cases shown above).
  • Unlike with Infinity (case-sensitive) in some cases, constants from the Number and Math objects passed as test cases in string format to any of the methods above will be determined to not be numbers.
  • See here for an explanation of how arguments are converted to a Number and why the edge cases for null and empty strings exist.
3
  • See also stackoverflow.com/questions/46677774/…
    – Philip
    Mar 13, 2020 at 17:26
  • fails "", null, undefined and
    – gman
    Jan 12, 2021 at 5:36
  • @gman thanks for pointing out the edge cases. I updated the answer to address the ones you mentioned as well as Infinity and "Infinity". It also looks like undefined is already handled properly but I added it explicitly to make it clear. Jan 16, 2021 at 4:41
6

This way it works for me.

function isNumeric(num){
    let value1 = num.toString();
    let value2 = parseFloat(num).toString();
    return (value1 === value2);
}

console.log(
    isNumeric(123),     //true
    isNumeric(-123),    //true
    isNumeric('123'),   //true
    isNumeric('-123'),  //true
    isNumeric(12.2),    //true
    isNumeric(-12.2),   //true
    isNumeric('12.2'),  //true
    isNumeric('-12.2'), //true
    isNumeric('a123'),  //false
    isNumeric('123a'),  //false
    isNumeric(' 123'),  //false
    isNumeric('123 '),  //false
    isNumeric('a12.2'), //false
    isNumeric('12.2a'), //false
    isNumeric(' 12.2'), //false
    isNumeric('12.2 '), //false
)
4

This is built on some of the previous answers and comments. It covers all the edge cases and also handles scientific notation optionally:

const NUMBER_REG_EXP = /^-?\d+(?:\.\d+)?$/;
const SCIENTIFIC_NOTATION_REG_EXP = /^-?\d+(?:\.\d+)?(?:[eE]\d+)?$/;

const isNumeric = (n, allowScientificNotation = false) => (
    (typeof n === 'number' && !Number.isNaN(n)) || 
    (typeof n === 'string' && (allowScientificNotation ?
        SCIENTIFIC_NOTATION_REG_EXP : NUMBER_REG_EXP).test(n))
);
3

If anyone ever gets this far down, I spent some time hacking on this trying to patch moment.js (https://github.com/moment/moment). Here's something that I took away from it:

function isNumeric(val) {
    var _val = +val;
    return (val !== val + 1) //infinity check
        && (_val === +val) //Cute coercion check
        && (typeof val !== 'object') //Array/object check
}

Handles the following cases:

True! :

isNumeric("1"))
isNumeric(1e10))
isNumeric(1E10))
isNumeric(+"6e4"))
isNumeric("1.2222"))
isNumeric("-1.2222"))
isNumeric("-1.222200000000000000"))
isNumeric("1.222200000000000000"))
isNumeric(1))
isNumeric(0))
isNumeric(-0))
isNumeric(1010010293029))
isNumeric(1.100393830000))
isNumeric(Math.LN2))
isNumeric(Math.PI))
isNumeric(5e10))

False! :

isNumeric(NaN))
isNumeric(Infinity))
isNumeric(-Infinity))
isNumeric())
isNumeric(undefined))
isNumeric('[1,2,3]'))
isNumeric({a:1,b:2}))
isNumeric(null))
isNumeric([1]))
isNumeric(new Date()))

Ironically, the one I am struggling with the most:

isNumeric(new Number(1)) => false

Any suggestions welcome. :]

2
  • 2
    What about isNumeric(' ') and isNumeric('')?
    – Alex Cory
    Jan 31, 2017 at 4:00
  • I would add && (val.replace(/\s/g,'') !== '') //Empty && (val.slice(-1) !== '.') //Decimal without Number in order to adress the above mentioned issue and one I had myself. Jan 15, 2018 at 19:08
3

I recently wrote an article about ways to ensure a variable is a valid number: https://github.com/jehugaleahsa/artifacts/blob/master/2018/typescript_num_hack.md The article explains how to ensure floating point or integer, if that's important (+x vs ~~x).

The article assumes the variable is a string or a number to begin with and trim is available/polyfilled. It wouldn't be hard to extend it to handle other types, as well. Here's the meat of it:

// Check for a valid float
if (x == null
    || ("" + x).trim() === ""
    || isNaN(+x)) {
    return false;  // not a float
}

// Check for a valid integer
if (x == null
    || ("" + x).trim() === ""
    || ~~x !== +x) {
    return false;  // not an integer
}
3

Save yourself the headache of trying to find a "built-in" solution.

There isn't a good answer, and the hugely upvoted answer in this thread is wrong.

npm install 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'
3
function isNumberCandidate(s) {
  const str = (''+ s).trim();
  if (str.length === 0) return false;
  return !isNaN(+str);
}

console.log(isNumberCandidate('1'));       // true
console.log(isNumberCandidate('a'));       // false
console.log(isNumberCandidate('000'));     // true
console.log(isNumberCandidate('1a'));      // false 
console.log(isNumberCandidate('1e'));      // false
console.log(isNumberCandidate('1e-1'));    // true
console.log(isNumberCandidate('123.3'));   // true
console.log(isNumberCandidate(''));        // false
console.log(isNumberCandidate(' '));       // false
console.log(isNumberCandidate(1));         // true
console.log(isNumberCandidate(0));         // true
console.log(isNumberCandidate(NaN));       // false
console.log(isNumberCandidate(undefined)); // false
console.log(isNumberCandidate(null));      // false
console.log(isNumberCandidate(-1));        // true
console.log(isNumberCandidate('-1'));      // true
console.log(isNumberCandidate('-1.2'));    // true
console.log(isNumberCandidate(0.0000001)); // true
console.log(isNumberCandidate('0.0000001')); // true
console.log(isNumberCandidate(Infinity));    // true
console.log(isNumberCandidate(-Infinity));    // true

console.log(isNumberCandidate('Infinity'));  // true

if (isNumberCandidate(s)) {
  // use +s as a number
  +s ...
}
0
3

So, it will depend on the test cases that you want it to handle.

function isNumeric(number) {
  return !isNaN(parseFloat(number)) && !isNaN(+number);
}

What I was looking for was regular types of numbers in javascript. 0, 1 , -1, 1.1 , -1.1 , 1E1 , -1E1 , 1e1 , -1e1, 0.1e10, -0.1.e10 , 0xAF1 , 0o172, Math.PI, Number.NEGATIVE_INFINITY, Number.POSITIVE_INFINITY

And also they're representations as strings:
'0', '1', '-1', '1.1', '-1.1', '1E1', '-1E1', '1e1', '-1e1', '0.1e10', '-0.1.e10', '0xAF1', '0o172'

I did want to leave out and not mark them as numeric '', ' ', [], {}, null, undefined, NaN

As of today, all other answers seemed to failed one of these test cases.

1
  • 1
    Note that isNumeric('007') returns true in case that matters to you
    – epan
    Jun 17, 2021 at 19:46
2

PFB the working solution:

 function(check){ 
    check = check + "";
    var isNumber =   check.trim().length>0? !isNaN(check):false;
    return isNumber;
    }
2

This appears to catch the seemingly infinite number of edge cases:

function isNumber(x, noStr) {
    /*

        - Returns true if x is either a finite number type or a string containing only a number
        - If empty string supplied, fall back to explicit false
        - Pass true for noStr to return false when typeof x is "string", off by default

        isNumber(); // false
        isNumber([]); // false
        isNumber([1]); // false
        isNumber([1,2]); // false
        isNumber(''); // false
        isNumber(null); // false
        isNumber({}); // false
        isNumber(true); // false
        isNumber('true'); // false
        isNumber('false'); // false
        isNumber('123asdf'); // false
        isNumber('123.asdf'); // false
        isNumber(undefined); // false
        isNumber(Number.POSITIVE_INFINITY); // false
        isNumber(Number.NEGATIVE_INFINITY); // false
        isNumber('Infinity'); // false
        isNumber('-Infinity'); // false
        isNumber(Number.NaN); // false
        isNumber(new Date('December 17, 1995 03:24:00')); // false
        isNumber(0); // true
        isNumber('0'); // true
        isNumber(123); // true
        isNumber(123.456); // true
        isNumber(-123.456); // true
        isNumber(-.123456); // true
        isNumber('123'); // true
        isNumber('123.456'); // true
        isNumber('.123'); // true
        isNumber(.123); // true
        isNumber(Number.MAX_SAFE_INTEGER); // true
        isNumber(Number.MAX_VALUE); // true
        isNumber(Number.MIN_VALUE); // true
        isNumber(new Number(123)); // true
    */

    return (
        (typeof x === 'number' || x instanceof Number || (!noStr && x && typeof x === 'string' && !isNaN(x))) &&
        isFinite(x)
    ) || false;
};

Not the answer you're looking for? Browse other questions tagged or ask your own question.