RegExp.prototype.dotAll - JavaScript | MDN

Try it

const regex1 = /f.o/s;

console.log(regex1.dotAll);
// Expected output: true

const regex2 = /bar/;

console.log(regex2.dotAll);
// Expected output: false

Description

RegExp.prototype.dotAll has the value true if the s flag was used; otherwise, false. The s flag indicates that the dot special character (.) should additionally match the following line terminator ("newline") characters in a string, which it would not match otherwise:

  • U+000A LINE FEED (LF) (\n)
  • U+000D CARRIAGE RETURN (CR) (\r)
  • U+2028 LINE SEPARATOR
  • U+2029 PARAGRAPH SEPARATOR

This effectively means the dot will match any UTF-16 code unit. However, it will not match characters that are outside of the Unicode Basic Multilingual Plane (BMP), also known as astral characters, which are represented as surrogate pairs and necessitate matching with two . patterns instead of one.

js

"๐Ÿ˜„".match(/(.)(.)/s);
// Array(3) [ "๐Ÿ˜„", "\ud83d", "\ude04" ]

The u (unicode) flag can be used to allow the dot to match astral characters as a single character.

js

"๐Ÿ˜„".match(/./su);
// Array [ "๐Ÿ˜„" ]

Note that a pattern such as .* is still capable of consuming astral characters as part of a larger context, even without the u flag.

js

"๐Ÿ˜„".match(/.*/s);
// Array [ "๐Ÿ˜„" ]

Using both the s and u flags in conjunction allows the dot to match any Unicode character in a more intuitive manner.

The set accessor of dotAll is undefined. You cannot change this property directly.

Examples

Using dotAll

js

const str1 = "bar\nexample foo example";

const regex1 = /bar.example/s;

console.log(regex1.dotAll); // true

console.log(str1.replace(regex1, "")); // foo example

const str2 = "bar\nexample foo example";

const regex2 = /bar.example/;

console.log(regex2.dotAll); // false

console.log(str2.replace(regex2, ""));
// bar
// example foo example

Specifications

Specification
ECMAScriptยฎ 2027 Language Specification
# sec-get-regexp.prototype.dotAll

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.