RegExp.prototype.hasIndices

Baseline Widely available

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

Die Zugriffsoroperty hasIndices von RegExp-Instanzen gibt an, ob das d-Flag mit diesem regulären Ausdruck verwendet wird.

Probieren Sie es aus

const regex1 = /foo/d;

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

const regex2 = /bar/;

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

Beschreibung

RegExp.prototype.hasIndices hat den Wert true, wenn das d-Flag verwendet wurde, andernfalls false. Das d-Flag gibt an, dass das Ergebnis eines regulären Ausdrucks-Matches die Start- und Endindizes der Teilzeichenfolgen jeder Erfassungsgruppe enthalten soll. Es ändert die Interpretation oder das Match-Verhalten des regulären Ausdrucks in keiner Weise, sondern liefert nur zusätzliche Informationen im Matchergebnis.

Dieses Flag wirkt sich hauptsächlich auf den Rückgabewert von exec() aus. Wenn das d-Flag vorhanden ist, enthält das von exec() zurückgegebene Array eine zusätzliche indices-Eigenschaft, wie im Rückgabewert der Methode exec() beschrieben. Da alle anderen regex-bezogenen Methoden (wie String.prototype.match()) intern exec() aufrufen, geben sie ebenfalls die Indizes zurück, wenn der reguläre Ausdruck das d-Flag hat.

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

Beispiele

Ein ausführlicheres Anwendungsbeispiel finden Sie unter Gruppen und Rückverweise > Verwenden von Gruppen und Match-Indizes.

Verwendung von hasIndices

js
const str1 = "foo bar foo";

const regex1 = /foo/dg;

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

console.log(regex1.exec(str1).indices[0]); // [0, 3]
console.log(regex1.exec(str1).indices[0]); // [8, 11]

const str2 = "foo bar foo";

const regex2 = /foo/;

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

console.log(regex2.exec(str2).indices); // undefined

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-get-regexp.prototype.hasIndices

Browser-Kompatibilität

Siehe auch