---
title: Symbol.match
slug: Web/JavaScript/Reference/Global_Objects/Symbol/match
tags:
  - ECMAScript 2015
  - JavaScript
  - Property
  - Symbol
translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/match
---
<div>{{JSRef}}</div>

<p><strong><code>Symbol.match</code></strong> は、文字列に対して正規表現のマッチングを指定します。この関数は {{jsxref("String.prototype.match()")}} メソッドによって呼び出されます。</p>

<div>{{EmbedInteractiveExample("pages/js/symbol-match.html")}}</div>



<h2 id="Description" name="Description">説明</h2>

<p>この関数は、オブジェクトが正規表現の動作をするかどうかを識別するためにも使用されます。たとえば、{{jsxref("String.prototype.startsWith()")}}, {{jsxref("String.prototype.endsWith()")}}, {{jsxref("String.prototype.includes()")}} メソッドは、最初の引数が正規表現であるかどうかを確認し、正規表現である場合は {{jsxref("TypeError")}} を投げます。ここで、<code>一致</code>記号が <code>false</code>（または<a href="/ja/docs/Glossary/Falsy">偽値</a>）に設定されている場合、そのオブジェクトが正規表現オブジェクトとして使用されることを意図していないことを示します。</p>

<p>{{js_property_attributes(0,0,0)}}</p>

<h2 id="Examples" name="Examples">例</h2>

<h3 id="Disabling_the_isRegExp_check" name="Disabling_the_isRegExp_check"><code>isRegExp</code> チェックを無効にする</h3>

<p>以下のコードは {{jsxref("TypeError")}} を投げます。</p>

<pre class="brush: js notranslate">'/bar/'.startsWith(/bar/);

// Throws TypeError, as /bar/ is a regular expression
// and Symbol.match is not modified.</pre>

<p>ただし、<code>Symbol.match</code> を <code>false</code> に設定すると、（<code>match</code> プロパティを使用する）<code>isRegExp</code> チェックは、オブジェクトが正規表現オブジェクトではないことを示します。結果として、<code>startsWith</code> と <code>endsWith</code> メソッドは、TypeError を投げません。</p>

<pre class="brush: js notranslate">var re = /foo/;
re[Symbol.match] = false;
'/foo/'.startsWith(re); // true
'/baz/'.endsWith(re);   // false
</pre>

<h2 id="Specifications" name="Specifications">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様書</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-symbol.match', 'Symbol.match')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>



<p>{{Compat("javascript.builtins.Symbol.match")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{jsxref("Symbol.replace")}}</li>
 <li>{{jsxref("Symbol.search")}}</li>
 <li>{{jsxref("Symbol.split")}}</li>
 <li>{{jsxref("RegExp.@@match", "RegExp.prototype[@@match]()")}}</li>
</ul>