Skip to main content

How to Check if a String Contains Numbers in JavaScript

Validating strings to see if they contain numbers is a common task, but the definition of "contains numbers" can mean two very different things. Do you want to know if a string has at least one number anywhere in it, or if the string consists only of numbers?

This guide will teach you how to solve both of these problems using simple and effective regular expressions. You will learn how to use the .test() method to get a clear true or false result for each scenario.

The Core Tool: Regular Expressions​

A regular expression is a special pattern used to match character combinations in strings. The RegExp.prototype.test() method is the perfect tool for this job, as it takes a regex and returns a simple boolean: true if the pattern is found in the string, and false otherwise.

Solution 1: Check if a String Contains at least one Number​

This is the most common use case. You want to know if there is a digit anywhere in the string.

The logic:

  • We use a simple regular expression that just looks for a single digit.

The solution:

function containsNumber(str) {
  // The regex `/\d/` looks for any digit (0-9).
  return /\d/.test(str);
}

// ✅ Contains a number
console.log(containsNumber('hello 42 world'));  // Output: true
console.log(containsNumber('abc 123'));         // Output: true
console.log(containsNumber('1 street'));        // Output: true

// ⛔️ Does not contain a number
console.log(containsNumber('hello world'));     // Output: false
console.log(containsNumber(''));                // Output: false

Solution 2: Check if a String Contains only Numbers​

This is a stricter validation. The string must be composed entirely of digits from beginning to end, with no other characters allowed.

The logic:

  • We use a more specific regular expression with anchors (^ and $) to ensure the entire string is matched.

The solution:

function containsOnlyNumbers(str) {
  // The regex /^\d+$/ checks if the string contains one or more digits from start to end.
  return /^\d+$/.test(str);
}

// ✅ Contains only numbers
console.log(containsOnlyNumbers('1234'));         // Output: true
console.log(containsOnlyNumbers('987'));          // Output: true

// ⛔️ Contains other characters
console.log(containsOnlyNumbers('123hello123'));  // Output: false
console.log(containsOnlyNumbers('123.5'));        // Output: false (dot is not a digit)
console.log(containsOnlyNumbers(' 123 '));        // Output: false (contains spaces)

How the Regular Expressions Work​

Let's break down the two patterns.

For "Contains at Least One Number": /\d/​

  • / ... /: Defines a regular expression.
  • \d: A special character class that matches any single digit from 0 to 9.

Because this regex has no anchors, the .test() method will return true if it finds a digit anywhere in the string.

For "Contains Only Numbers": /^\d+$/​

  • ^: The start-of-string anchor. It asserts that the pattern must begin at the very start of the string.
  • \d: Matches a digit.
  • +: A quantifier that means "one or more" of the preceding token. So, \d+ matches one or more digits.
  • $: The end-of-string anchor. It asserts that the pattern must end at the very end of the string.

Together, this pattern means "the string must, from start to finish, consist of one or more digits and nothing else."

Conclusion​

Using regular expressions is the standard and most reliable way to check for numbers in a string.

The key takeaways are:

  1. To check if a string contains at least one number anywhere, use the simple regex: /\d/.test(str).
  2. To check if a string contains only numbers from start to finish, use the anchored regex: /^\d+$/.test(str).

By choosing the correct pattern for your specific needs, you can write clear, robust, and accurate validation logic.

Table of Contents