---
title: MediaStreamTrack.onoverconstrained
slug: Web/API/MediaStreamTrack/onoverconstrained
translation_of: Web/API/MediaStreamTrack/onoverconstrained
---
<p>{{ APIRef("Media Capture and Streams") }}</p>

<p><code><strong>MediaStreamTrack.onoverconstrained</strong></code>イベントハンドラは、{{event("overconstrained")}}イベントを受け取った時に呼び出されるプロパティです。このイベントは、影響を受けた各トラック(複数のトラックが同一のソースを共有している時)で発生します。このイベントは、ユーザエージェントが与えられたソースに対して現在の制約を評価し、与えられた制約でソースを設定することができない時に発生します。 過制約のため、ユーザエージェントは影響をうけた各トラックをミュートにします。影響を受けたトラックは、現在のソースの有効な能力に配慮してアプリケーションが制約を調整するまでmutedの状態を維持します。</p>

<p> </p>

<h2 id="文法">文法</h2>

<pre class="eval"><em>track</em>.onoverconstrained = <em>function</em>;
</pre>

<h3 id="値">値</h3>

<ul>
 <li><code>function</code>はユーザーが定義した関数の名前で末尾の<code>()</code>やパラメータを省略したもの、または、<code>function(event) {...}</code>の形式で表現された匿名関です。イベントハンドラは常に 、{{domxref("MediaStreamErrorEvent")}}型のイベントを含む1つのパラメータを持ちます。</li>
</ul>

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

<pre class="brush: js">dc.onoverconstrained = function(ev) { alert("overconstrained event detected!"); };
</pre>

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

<table class="standard-table" style="height: 49px; width: 1000px;">
 <thead>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状況</th>
   <th scope="col">コメント</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('Media Capture', '#widl-MediaStreamTrack-onoverconstrained', 'MediaStreamTrack.onoverconstrained') }}</td>
   <td>{{ Spec2('Media Capture') }}</td>
   <td>初版</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ互換性">ブラウザ互換性</h2>

<p>{{Compat("api.MediaStreamTrack.onoverconstrained")}}</p>

<h2 id="関連項目">関連項目</h2>

<ul>
 <li>{{event("overconstrained")}}イベント、およびその型である {{domxref("MediaStreamErrorEvent")}}。</li>
</ul>