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

<p><code><strong>MediaStreamTrack.onended</strong></code> イベントハンドラは<code><a href="/ja/docs/Web/Reference/Events/ended_(MediaStream)" rel="nofollow" title="/ja/docs/Web/Reference/Events/ended_(MediaStream)">ended</a></code>イベントが発生した時に実行する<code><a href="/ja/docs/Web/API/EventHandler" rel="nofollow" title="この項目についての文書はまだ書かれていません。書いてみませんか？">EventHandler</a></code>の関数です。このイベントは、<a href="/ja/docs/Web/API/MediaStreamTrack" title="MediaStreamTrack インタフェースは、ストリームに含まれる一つのメディアトラックを表現します。 一般的に、オーディオやビデオのトラックですが、他の種類のトラックも存在することができます。"><code>MediaStreamTrack</code></a>オブジェクトのソースが、これ以上データを提供することがないか、ユーザーの操作によって許可が無効になったか、ソースデバイスが取り出されたか、リモートのピアがデータの送信を停止した時に発生します。</p>

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

<pre class="syntaxbox"><em>MediaStreamTrack</em>.onended = <em>function</em>;
</pre>

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

<p>{{event("ended")}}イベントが発生した時の実行する処理の関数を{{event("Event_handlers", "event handler")}}として設定します。このイベントハンドラーの関数は1つのパラメータ持ちます。このパラメータはイベントオブジェクトであり、単純な{{domxref("Event")}}のオブジェクトです。</p>

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

<p>この例では、endedイベントのイベントハンドラを設定しています。このイベントハンドラでは、トラックがアクティブでない状態を示すために画面上のアイコンを変更します。</p>

<pre class="brush: js">track.onended = function(event) {
  let statusElem = document.getElementById("status-icon");

  statusElem.src = "/images/stopped-icon.png";
}
</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-onended', 'MediaStreamTrack.onended') }}</td>
   <td>{{ Spec2('Media Capture') }}</td>
   <td>初版</td>
  </tr>
 </tbody>
</table>

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

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

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

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