String.prototype.match()

regexp

Ein RegExp-Objekt oder ein beliebiges Objekt, das eine Symbol.match-Methode hat.

Wenn regexp kein RegExp-Objekt ist und keine Symbol.match-Methode hat, wird es implizit in ein RegExp mit new RegExp(regexp) umgewandelt.

Wenn Sie keinen Parameter angeben und die match()-Methode direkt verwenden, erhalten Sie ein Array mit einem leeren String: [""], da dies gleichbedeutend ist mit match(/(?:)/).

Ein Array, dessen Inhalt von der Anwesenheit oder Abwesenheit des globalen (g)-Flags abhängt, oder null, wenn keine Übereinstimmungen gefunden werden.

• Wenn das g-Flag verwendet wird, werden alle Ergebnisse, die dem gesamten regulären Ausdruck entsprechen, zurückgegeben, aber erfasste Gruppen sind nicht enthalten.
• Wenn das g-Flag nicht verwendet wird, wird nur die erste vollständige Übereinstimmung und deren zugehörige erfasste Gruppen zurückgegeben. In diesem Fall gibt match() dasselbe Ergebnis zurück wie RegExp.prototype.exec() (ein Array mit einigen zusätzlichen Eigenschaften).

Die Implementierung von String.prototype.match tut nicht viel mehr, als die Symbol.match-Methode des Arguments mit dem String als ersten Parameter aufzurufen. Die eigentliche Implementierung stammt von RegExp.prototype[Symbol.match]().

• Wenn Sie wissen müssen, ob ein String einem regulären Ausdruck entspricht, verwenden Sie RegExp.prototype.test().
• Wenn Sie nur die erste gefundene Übereinstimmung möchten, möchten Sie möglicherweise RegExp.prototype.exec() stattdessen verwenden.
• Wenn Sie Erfassungsgruppen erhalten möchten und das globale Flag gesetzt ist, müssen Sie RegExp.prototype.exec() oder String.prototype.matchAll() stattdessen verwenden.

Für weitere Informationen über die Semantik von match() bei übergebenem Regex siehe RegExp.prototype[Symbol.match]().

Im folgenden Beispiel wird match() verwendet, um "Chapter" zu finden, gefolgt von einem oder mehreren numerischen Zeichen, gefolgt von einem Dezimalpunkt und numerischen Zeichen, null oder mehrmals.

Der reguläre Ausdruck enthält das i-Flag, sodass Groß-/Kleinschreibung ignoriert wird.

const str = "For more information, see Chapter 3.4.5.1";
const re = /see (chapter \d+(\.\d)*)/i;
const found = str.match(re);

console.log(found);
// [
//   'see Chapter 3.4.5.1',
//   'Chapter 3.4.5.1',
//   '.1',
//   index: 22,
//   input: 'For more information, see Chapter 3.4.5.1',
//   groups: undefined
// ]

Im obigen Match-Ergebnis ist 'see Chapter 3.4.5.1' die gesamte Übereinstimmung. 'Chapter 3.4.5.1' wurde von (chapter \d+(\.\d)*) erfasst. '.1' war der letzte Wert, der von (\.\d) erfasst wurde. Die index-Eigenschaft (22) ist der nullbasierte Index der gesamten Übereinstimmung. Die input-Eigenschaft ist der ursprüngliche String, der geparst wurde.

Das folgende Beispiel zeigt die Verwendung des globalen Flags und des Ignore-Case-Flags mit match(). Alle Buchstaben A bis E und a bis e werden zurückgegeben, jeder als eigenes Element im Array.

const str = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
const regexp = /[A-E]/gi;
const matches = str.match(regexp);

console.log(matches);
// ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']

In Browsern, die benannte Erfassungsgruppen unterstützen, erfasst der folgende Code "fox" oder "cat" in einer Gruppe namens animal:

const paragraph = "The quick brown fox jumps over the lazy dog. It barked.";

const capturingRegex = /(?<animal>fox|cat) jumps over/;
const found = paragraph.match(capturingRegex);
console.log(found.groups); // {animal: "fox"}

Wenn ein Objekt eine Symbol.match-Methode hat, kann es als benutzerdefinierter Matcher verwendet werden. Der Rückgabewert von Symbol.match wird zum Rückgabewert von match().

const str = "Hmm, this is interesting.";

str.match({
  [Symbol.match](str) {
    return ["Yes, it's interesting."];
  },
}); // returns ["Yes, it's interesting."]

Wenn der regexp-Parameter ein String oder eine Zahl ist, wird er implizit in ein RegExp durch die Verwendung von new RegExp(regexp) umgewandelt.

const str1 =
  "NaN means not a number. Infinity contains -Infinity and +Infinity in JavaScript.";
const str2 =
  "My grandfather is 65 years old and My grandmother is 63 years old.";
const str3 = "The contract was declared null and void.";
str1.match("number"); // "number" is a string. returns ["number"]
str1.match(NaN); // the type of NaN is the number. returns ["NaN"]
str1.match(Infinity); // the type of Infinity is the number. returns ["Infinity"]
str1.match(+Infinity); // returns ["Infinity"]
str1.match(-Infinity); // returns ["-Infinity"]
str2.match(65); // returns ["65"]
str2.match(+65); // A number with a positive sign. returns ["65"]
str3.match(null); // returns ["null"]

Dies kann unerwartete Ergebnisse haben, wenn Sonderzeichen nicht richtig maskiert sind.

console.log("123".match("1.3")); // [ "123" ]

Dies ist eine Übereinstimmung, da . in einem Regex jedes Zeichen trifft. Um es nur speziell mit einem Punkt-Zeichen übereinstimmen zu lassen, müssen Sie die Eingabe maskieren.

console.log("123".match("1\\.3")); // null

• Polyfill von String.prototype.match in core-js mit Korrekturen und Implementierung moderner Verhaltensweisen wie Symbol.match-Unterstützung
• Leitfaden für reguläre Ausdrücke
• String.prototype.matchAll()
• RegExp
• RegExp.prototype.exec()
• RegExp.prototype.test()