RegExp.prototype.dotAll

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die dotAll Accessor-Eigenschaft von RegExp Instanzen gibt zurück, ob das s-Flag mit diesem regulären Ausdruck verwendet wird oder nicht.

Probieren Sie es aus

Beschreibung

RegExp.prototype.dotAll hat den Wert true, wenn das s-Flag verwendet wurde; andernfalls false. Das s-Flag gibt an, dass das spezielle Zeichen Punkt (.) zusätzlich die folgenden Zeilenabschlusszeichen ("Newline") in einem String matchen soll, die es sonst nicht matchen würde:

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

Dies bedeutet effektiv, dass der Punkt jede UTF-16 Codeeinheit matchen wird. Er wird jedoch keine Zeichen matchen, die außerhalb der Unicode Basic Multilingual Plane (BMP) liegen, auch bekannt als astrale Zeichen, die als Surrogatpaare dargestellt werden und es erfordern, mit zwei . Mustern statt einem zu matchen.

js
"😄".match(/(.)(.)/s);
// Array(3) [ "😄", "\ud83d", "\ude04" ]

Das u (Unicode)-Flag kann verwendet werden, um dem Punkt zu ermöglichen, astrale Zeichen als ein einzelnes Zeichen zu matchen.

js
"😄".match(/./su);
// Array [ "😄" ]

Beachten Sie, dass ein Muster wie .* auch ohne das u-Flag in der Lage ist, astrale Zeichen als Teil eines größeren Kontextes zu konsumieren.

js
"😄".match(/.*/s);
// Array [ "😄" ]

Die gleichzeitige Verwendung der s- und u-Flags ermöglicht es dem Punkt, jedes Unicode-Zeichen auf intuitivere Weise zu matchen.

Der set-Accessor von dotAll ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Verwendung von 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

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-get-regexp.prototype.dotAll

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch