JavaScript RegExp toString() Method

What You’ll Learn

toString() turns a RegExp object into a readable /pattern/flags string. Use it for debugging, logging, error messages, and displaying the active pattern in tools or UI—without running a match.

Introduction

A RegExp object stores a pattern and flags internally. When you console.log a regex or embed it in a template literal, JavaScript needs a human-readable form. That is what toString() provides: a string that looks like the regex literal you might write in source code.

Unlike test() or exec(), toString() does not search text. It only describes the regex itself. That makes it perfect for debugging (“which pattern failed?”), building error messages, and showing users what rule is being applied.

Understanding the toString() Method

regex.toString() returns a string built from the RegExp’s source and flags:

• Format — "/" + source + "/" + flags, e.g. "/\\d+/g".
• No matching — purely descriptive; does not touch lastIndex or input strings.
• Coercion — String(regex), "" + regex, and `${regex}` all use the same conversion.
• Empty flags — when no flags are set, the result ends with / and no trailing letters: "/hello/".

How to Use toString()

Call toString() when you need a display string, or rely on implicit conversion in logs and templates:

const regex = /^\w+@\w+\.\w+$/i;



console.log(regex.toString());     // /^\w+@\w+\.\w+$/i

console.log(`Pattern: ${regex}`);  // same via coercion



throw new Error(`Invalid input for ${regex.toString()}`);

Pair with test() or exec() in error handlers so users see both whether validation failed and which pattern was used.

📝 Syntax

regex.toString()

Parameters

• None.

Return value

• A string in /pattern/flags form.

Related properties

regex.source  // pattern text only

regex.flags   // flag letters only

regex.toString()  // "/" + source + "/" + flags

Examples Gallery

Open DevTools Console (F12) or use Try-it links. Examples cover literal regexes, constructor-created patterns, logging, source/flags breakdown, and template literal coercion.

const regex = /hello/gi;



console.log(regex.toString());  // "/hello/gi"

console.log(typeof regex.toString());  // "string"

/hello/gi

string

const regex = new RegExp("a+b", "i");



console.log(regex.toString());  // "/a+b/i"

console.log(regex.source);      // "a+b"

console.log(regex.flags);       // "i"

/a+b/i

a+b

i

const zipRule = /^\d{5}$/;



function validateZip(value) {

  if (!zipRule.test(value)) {

    return `Invalid ZIP. Expected pattern ${zipRule.toString()}`;

  }

  return "Valid";

}



console.log(validateZip("90210"));  // Valid

console.log(validateZip("9021"));   // Invalid ZIP. Expected pattern /^\d{5}$/

Valid

Invalid ZIP. Expected pattern /^\d{5}$/

const regex = /\d+/g;



console.log("toString:", regex.toString());  // /\d+/g

console.log("source:", regex.source);        // \d+

console.log("flags:", regex.flags);          // g

toString: /\d+/g

source: \d+

flags: g

const regex = /world/;



console.log(String(regex));       // "/world/"

console.log("" + regex);          // "/world/"

console.log(`Found with ${regex}`);  // Found with /world/

/world/

/world/

Found with /world/

🚀 Common Use Cases

• Console debugging — log the active pattern when regex behavior is unexpected.
• Error messages — tell users or developers which validation rule failed.
• Test output — display expected patterns in unit test failure diffs.
• Documentation tools — show live regex config in admin or config panels.
• Serialization hints — pair with source and flags for storage.
• Learning aids — compare literal syntax with dynamic RegExp objects.

Important Considerations

• Not for matching — toString() does not test or exec against strings.
• Do not parse output — prefer source and flags over splitting the string.
• Escaping in source — source may show double backslashes for escaped characters.
• Not JSON-safe alone — store source and flags as separate fields when persisting.
• Differs from match results — match arrays have their own toString() behavior (comma-joined).
• Empty flags omitted visually — /hello/ has no flag letters after the slash.

📝 Notes

• toString() is inherited from Object.prototype but overridden on RegExp.
• Previous topic: compile() legacy method.
• Next topic: constructor property.
• See test() for boolean matching.
• See global property for the g flag.
• Clone safely: new RegExp(r.source, r.flags).

💡 Best Practices