RegExp.prototype.compile()

Baseline Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Note: The compile() method is only specified for compatibility reasons. Using compile() causes the otherwise immutable regex source and flags to become mutable, which may break user expectations. You can use the RegExp() constructor to construct a new regular expression object instead.

The compile() method of RegExp instances is used to recompile a regular expression with new source and flags after the RegExp object has already been created.

Syntax

compile(pattern, flags)

Parameters

pattern: The text of the regular expression.
flags: Any combination of flag values.

Return value

None (undefined).

Exceptions

TypeError: Thrown if the this value is not an instance of the current realm's RegExp constructor. This includes a subclass of RegExp and the RegExp constructor from a different realm.

Examples

Using compile()

The following example shows how to recompile a regular expression with a new pattern and a new flag.

const regexObj = /foo/gi;
regexObj.compile("new foo", "g");

Specifications

Specification
ECMAScript® 2027 Language Specification # sec-regexp.prototype.compile

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`compile`	1	12	1	6	3.1	18	4	10.1	2	1.0	4.4	2	1.0.0	1.0	0.10.0
`rexexp_legacy_features`	No	No	148	No	15.6	No	148	No	15.6	No	No	15.6	No	No	No