This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

active

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨сентябрь 2017 г.⁩.

Свойство только для чтения active интерфейса MediaStream возвращает логическое значение, которое может быть true, если стрим активен; во всех остальных случаях, будет возвращён false. Стрим считается активным, если хотя бы один из MediaStreamTrack не находится в состоянии MediaStreamTrack.ended. Как только все track завершатся, свойство active переключится в состояние false.

Синтаксис

var isActive = MediaStream.active;

Значение

Логическое значение равно true, если стрим активен; в противном случае, возвращается false.

Пример

В этом примере, стрим ведётся с пользовательского микрофона и веб-камеры, запрошенных с помощью getUserMedia(). Когда стрим становится активным (а это тогда, когда выполнен Promise, кнопка на странице обновляется, опираясь на состояние стрима, активен он или же нет.

js
var promise = navigator.mediaDevices.getUserMedia({
  audio: true,
  video: true
});

promise.then(function(stream) {
  var startBtn = document.querySelector('#startBtn');
  startBtn.disabled = stream.active;
};)

Спецификации

Specification
Media Capture and Streams
# dom-mediastream-active

Совместимость с браузерами