Symbol.match

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.

Symbol.match は静的データプロパティで、ウェルノウンシンボルの Symbol.match を表します。String.prototype.match() メソッドは第 1 引数に対して、入力文字列と現在のオブジェクトとの照合に使われるメソッドを、このシンボルで探します。このシンボルは、オブジェクトが正規表現として扱われるべきかどうかを決定するためにも使用されます。

詳しくは、RegExp.prototype[Symbol.match]() および String.prototype.match() を参照してください。

試してみましょう

const regexp = /foo/;
// console.log('/foo/'.startsWith(regexp));
// 予想される結果 (Chrome): Error: First argument to String.prototype.startsWith must not be a regular expression
// 予想される結果 (Firefox): Error: Invalid type: first can't be a Regular Expression
// 予想される結果 (Safari): Error: Argument to String.prototype.startsWith cannot be a RegExp

regexp[Symbol.match] = false;

console.log("/foo/".startsWith(regexp));
// 予想される結果: true

console.log("/baz/".endsWith(regexp1));
// 予想される結果: false

値

ウェルノウンシンボル Symbol.match です。

Symbol.match のプロパティ属性

書込可能	不可
列挙可能	不可
設定可能	不可

この関数は、オブジェクトが正規表現の動作をするかどうかを識別するためにも使用されます。たとえば、String.prototype.startsWith(), String.prototype.endsWith(), String.prototype.includes() メソッドは、最初の引数が正規表現であるかどうかを確認し、正規表現である場合は TypeError が発生します。ここで、match シンボルが false（または偽値、ただし undefined でないもの）に設定されている場合、そのオブジェクトが正規表現オブジェクトとして使用されることを意図していないことを示します。

例

isRegExp チェックを無効にする

以下のコードは TypeError を投げます。

js
"/bar/".startsWith(/bar/);

// TypeError が発生。/bar/ が正規表現であり、
// Symbol.match が変更されていないため。

ただし、Symbol.match を false に設定すると、オブジェクトが正規表現オブジェクトではないことを示します。結果として、startsWith と endsWith メソッドは、TypeError を発生させません。

js
const re = /foo/;
re[Symbol.match] = false;
"/foo/".startsWith(re); // true
"/baz/".endsWith(re); // false

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-symbol.match

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年11月13日 by MDN contributors.

View this page on GitHub • Report a problem with this content

Symbol.match

In this article

試してみましょう

値

解説

例

isRegExp チェックを無効にする

仕様書

ブラウザーの互換性

関連情報

Help improve MDN