From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/string/matchall/index.html | 145 +++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/string/matchall/index.html (limited to 'files/ja/web/javascript/reference/global_objects/string/matchall/index.html') diff --git a/files/ja/web/javascript/reference/global_objects/string/matchall/index.html b/files/ja/web/javascript/reference/global_objects/string/matchall/index.html new file mode 100644 index 0000000000..12332968b5 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/string/matchall/index.html @@ -0,0 +1,145 @@ +--- +title: String.prototype.matchAll() +slug: Web/JavaScript/Reference/Global_Objects/String/matchAll +tags: + - JavaScript + - Method + - Prototype + - Reference + - Regular Expressions + - String +translation_of: Web/JavaScript/Reference/Global_Objects/String/matchAll +--- +
{{JSRef}}
+ +

matchAll() はキャプチャグループを含む正規表現に一致するすべての文字列をイテレーターで返すメソッドです。

+ +
{{EmbedInteractiveExample("pages/js/string-matchall.html")}}
+ + + +

構文

+ +
str.matchAll(regexp)
+ +

Parameters

+ +
+
regexp
+
+

正規表現オブジェクトです。

+ +

RegExp でないオブジェクト obj が渡された場合は {{jsxref("RegExp")}} オブジェクトに new RegExp(obj) を使用して暗黙的に変換されます。

+ +

RegExp オブジェクトには /g フラグが必須であり、ない場合は TypeError が発生します。

+
+
+ +

返値

+ +

イテレーター (再起動不可能なもの)。

+ +

例

+ +

Regexp.exec() と matchAll()

+ +

matchAll が JavaScript に追加される前は、 regexp.exec (および /g フラグ付きの正規表現) をループの中で呼び出すことですべての一致結果を取得することができました。

+ +
const regexp = RegExp('foo[a-z]*','g');
+const str = 'table football, foosball';
+let match;
+
+while ((match = regexp.exec(str)) !== null) {
+  console.log(`Found ${match[0]} start=${match.index} end=${regexp.lastIndex}.`);
+  // expected output: "Found football start=6 end=14."
+  // expected output: "Found foosball start=16 end=24."
+}
+ +

matchAll が使えるようになったことで、 {{jsxref("Statements/while", "while")}} によるループと、 g 付きの exec を避けることができます。

+ +

また代わりに matchAll を使うことで、 {{jsxref("Statements/for...of", "for...of")}}、 {{jsxref("Operators/Spread_syntax", "配列スプレッド", "", 1)}}、 {{jsxref("Array.from()")}} 構造と効率よく組み合わせることができます。

+ +
const regexp = RegExp('foo[a-z]*','g');
+const str = 'table football, foosball';
+const matches = str.matchAll(regexp);
+
+for (const match of matches) {
+  console.log(`Found ${match[0]} start=${match.index} end=${match.index + match[0].length}.`);
+}
+// expected output: "Found football start=6 end=14."
+// expected output: "Found foosball start=16 end=24."
+
+// matches iterator is exhausted after the for..of iteration
+// Call matchAll again to create a new iterator
+Array.from(str.matchAll(regexp), m => m[0]);
+// Array [ "football", "foosball" ]
+ +

matchAll は、グローバル (g) フラグがない場合は例外が発生します。

+ +
const regexp = RegExp('[a-c]','');
+const str = 'abc';
+str.matchAll(regexp);
+// TypeError
+
+ +

matchAll では内部的に {{jsxref("RegExp")}} オブジェクトをクローンします。そのため {{jsxref("Global_Objects/RegExp/exec", "regexp.exec()")}} とは違って文字列をスキャンした際に lastIndex が変わることはありません。

+ +
const regexp = RegExp('[a-c]','g');
+regexp.lastIndex = 1;
+const str = 'abc';
+Array.from(str.matchAll(regexp), m => `${regexp.lastIndex} ${m[0]}`);
+// Array [ "1 b", "1 c" ]
+ +

キャプチャリンググループへのより良いアクセス（String.prototype.match()との比較）

+ +

matchAll はキャプチャグループへのよりよいアクセスを実現します。

+ +

{{jsxref("Global_Objects/String/match", "match()")}} では、グローバル /g フラグを使用するとキャプチャグループが無視されてしまいます。

+ +
let regexp = /t(e)(st(\d?))/g;
+let str = 'test1test2';
+
+str.match(regexp);
+// Array ['test1', 'test2']
+ +

matchAll を使えば簡単にキャプチャグループにアクセスできます。

+ +
let array = [...str.matchAll(regexp)];
+
+array[0];
+// ['test1', 'e', 'st1', '1', index: 0, input: 'test1test2', length: 4]
+array[1];
+// ['test2', 'e', 'st2', '2', index: 5, input: 'test1test2', length: 4]
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-string.prototype.matchall', 'String.prototype.matchAll')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("javascript.builtins.String.matchAll")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf