The NIA sleuths will interrogate them in custody till November 14, said a source privy to the investigation

Embossing is a graphical effect used to give the impression that the surface of an image has been raised or pressed in. In web design, an embossed text effect can give your typography a three-dimensional look and feel, often lending …

CSS truly is a remarkable tool in a web designer’s toolkit, capable of bringing even the most vibrant creative visions to life. Today, we’re immersing ourselves in the radiant world of neon style buttons, showcasing the impressive spectrum of CSS …

Web design takes a captivating turn when CSS comes into play. It enables a world of transformations, such as taking static text elements and infusing them with life. Our focus today is one such engaging transformation – animate gradient text …

Google’s Material Design guidelines introduced the ripple effect, a subtle animation that indicates user action. The ripple effect rapidly gained popularity in web design as a sophisticated visual feedback form that refines user interaction, particularly on buttons. Today, we’ll show …

Chris Mills brushes up his shorthand and shows how the MediaStream Recording API in modern browsers can be used to capture audio directly from the user’s device. Inching ever closer to the capabilities of native software, it truly is an exciting time to be a web developer.

The MediaStream Recording API makes it easy to record audio and/or video streams. When used with MediaDevices.getUserMedia(), it provides an easy way to record media from the user’s input devices and instantly use the result in web apps. This article shows how to use these technologies to create a fun dictaphone app.

A sample application: Web Dictaphone

To demonstrate basic usage of the MediaRecorder API, we have built a web-based dictaphone. It allows you to record snippets of audio and then play them back. It even gives you a visualisation of your device’s sound input, using the Web Audio API. We’ll just concentrate on the recording and playback functionality in this article, for brevity’s sake.

You can see this demo running live, or grab the source code on GitHub. This has pretty good support on modern desktop browsers, but pretty patchy support on mobile browsers currently.

Basic app setup

To grab the media stream we want to capture, we use getUserMedia(). We then use the MediaRecorder API to record the stream, and output each recorded snippet into the source of a generated <audio> element so it can be played back.

We’ll first declare some variables for the record and stop buttons, and the <article> that will contain the generated audio players:

const record = document.querySelector('.record');
const stop = document.querySelector('.stop');
const soundClips = document.querySelector('.sound-clips');

Next, we set up the basic getUserMedia structure:

if (navigator.mediaDevices && navigator.mediaDevices.getUserMedia) {
   console.log('getUserMedia supported.');
   navigator.mediaDevices.getUserMedia (
      // constraints - only audio needed for this app
      {
         audio: true
      })

      // Success callback
      .then(function(stream) {

      })

      // Error callback
      .catch(function(err) {
         console.log('The following `getUserMedia` error occured: ' + err);
      }
   );
} else {
   console.log('getUserMedia not supported on your browser!');
}

The whole thing is wrapped in a test that checks whether getUserMedia is supported before running anything else. Next, we call getUserMedia() and inside it define:

• The constraints: Only audio is to be captured for our dictaphone.
• The success callback: This code is run once the getUserMedia call has been completed successfully.
• The error/failure callback: The code is run if the getUserMedia call fails for whatever reason.

Note: All of the code below is found inside the getUserMedia success callback in the finished version.

Capturing the media stream

Once getUserMedia has created a media stream successfully, you create a new Media Recorder instance with the MediaRecorder() constructor and pass it the stream directly. This is your entry point into using the MediaRecorder API — the stream is now ready to be captured into a <Blob>, in the default encoding format of your browser.

const mediaRecorder = new MediaRecorder(stream);

There are a series of methods available in the MediaRecorder interface that allow you to control recording of the media stream; in Web Dictaphone we just make use of two, and listen to some events. First of all, MediaRecorder.start() is used to start recording the stream once the record button is pressed:

record.onclick = function() {
  mediaRecorder.start();
  console.log(mediaRecorder.state);
  console.log("recorder started");
  record.style.background = "red";
  record.style.color = "black";
}

When the MediaRecorder is recording, the MediaRecorder.state property will return a value of “recording”.

As recording progresses, we need to collect the audio data. We register an event handler to do this using mediaRecorder.ondataavailable:

let chunks = [];

mediaRecorder.ondataavailable = function(e) {
  chunks.push(e.data);
}

Last, we use the MediaRecorder.stop() method to stop the recording when the stop button is pressed, and finalize the Blob ready for use somewhere else in our application.

stop.onclick = function() {
  mediaRecorder.stop();
  console.log(mediaRecorder.state);
  console.log("recorder stopped");
  record.style.background = "";
  record.style.color = "";
}

Note that the recording may also stop naturally if the media stream ends (e.g. if you were grabbing a song track and the track ended, or the user stopped sharing their microphone).

Grabbing and using the blob

When recording has stopped, the state property returns a value of “inactive”, and a stop event is fired. We register an event handler for this using mediaRecorder.onstop, and construct our blob there from all the chunks we have received:

mediaRecorder.onstop = function(e) {
  console.log("recorder stopped");

  const clipName = prompt('Enter a name for your sound clip');

  const clipContainer = document.createElement('article');
  const clipLabel = document.createElement('p');
  const audio = document.createElement('audio');
  const deleteButton = document.createElement('button');

  clipContainer.classList.add('clip');
  audio.setAttribute('controls', '');
  deleteButton.innerHTML = "Delete";
  clipLabel.innerHTML = clipName;

  clipContainer.appendChild(audio);
  clipContainer.appendChild(clipLabel);
  clipContainer.appendChild(deleteButton);
  soundClips.appendChild(clipContainer);

  const blob = new Blob(chunks, { 'type' : 'audio/ogg; codecs=opus' });
  chunks = [];
  const audioURL = window.URL.createObjectURL(blob);
  audio.src = audioURL;

  deleteButton.onclick = function(e) {
    let evtTgt = e.target;
    evtTgt.parentNode.parentNode.removeChild(evtTgt.parentNode);
  }
}

Let’s go through the above code and look at what’s happening.

First, we display a prompt asking the user to name their clip.

Next, we create an HTML structure like the following, inserting it into our clip container, which is an <article> element.

<article class="clip">
  <audio controls></audio>
  <p>_your clip name_</p>
  <button>Delete</button>
</article>

After that, we create a combined Blob out of the recorded audio chunks, and create an object URL pointing to it, using window.URL.createObjectURL(blob). We then set the value of the <audio> element’s src attribute to the object URL, so that when the play button is pressed on the audio player, it will play the Blob.

Finally, we set an onclick handler on the delete button to be a function that deletes the whole clip HTML structure.

So that’s basically it — we have a rough and ready dictaphone. Have fun recording those Christmas jingles! As a reminder, you can find the source code, and see it running live, on the MDN GitHub.

This article is based on Using the MediaStream Recording API by Mozilla Contributors, and is licensed under CC-BY-SA 2.5.

About the author

Chris Mills manages the MDN web docs writers’ team at Mozilla, which involves spreadsheets, meetings, writing docs and demos about open web technologies, and occasional tech talks at conferences and universities. He used to work for Opera and W3C, and enjoys playing heavy metal drums and drinking good beer.

More articles by Chris

Testing time it was for models from India and abroad during auditions of the Amazon India Fashion Week Spring-Summer 2017.

The new line of belts and bags are made from a plant-based, plastic-free material called Mirum

But food inflation could hold the RBI’s hand in reversing its interest rate cycle in the near future

Time to loosen export curbs on Indian rice

NIM moderates as deposits outpace credit growth

The portfolio asset quality continues to improve with Gross NPA at 1.24 percent as on end September 2024

Confident of sustaining Q2 bottomline growth performance in remaining quarters this fiscal 

Yes Bank’s standalone net profit more than doubled to ₹5.53 billion for the financial second quarter from ₹2.25 billion in the same period a year earlier

Deposit to continue growing faster than credit in H2FY25

For the quarter ended September 30, 2024, the company’s net profit surged by 34 per cent to ₹268 crore, up from ₹199 crore

With a 10,000-branch network, MD & CEO Goel eyes significant growth opportunities to expand business and scale new heights.

This new facility replaces paper-based BG issuance process with stamping and signatures

The Company achieved a 22 per cent % year-on-year increase in net profit in Q2 FY25, driven by business growth, stable asset quality, and a continuous focus on enhancing productivity

Shriram Life sold 2.83 lakh individual policies, a 96 per cent increase from the previous year

Montreal : National Film Board of Canada, 2016

Montreal : National Film Board of Canada, 2019

Montreal : National Film Board of Canada, 2022

The Chairman of the 20-Point Programme, Lanka Dinakar feels ₹16,075 crores allocated to irrigation projects in the Andhra Pradesh Budget will fulfill the agricultural, drinking water, and industrial needs of the State.

South Koreans are familiar with Andhra Pradesh and since Kia Motors is here, more Korean companies may wish to come too, says Sangwoo Lim

In advanced and emerging economies, inclusive growth and development can become a reality if there is a focus on key policy actions that have been identified

The danger of Donald Trump’s leadership lies in his willingness to exploit and manipulate information to achieve his goals

Cham, Switzerland : Springer, 2021.

Cham : Birkhäuser, 2022

New York : Routledge, 2020

Providence, Rhode Island : American Mathematical Society, [2023]

“In addition to brining in transparency, the bodycams will make police personnel more conscious and improve their conduct with people,” Mangaluru Police Commissioner Anupam Agrawal said

According to KSRTC officials, major routes that saw high demand included popular destinations from Bengaluru such as Davangere, Mysuru, Hubballi, Tirupathi, Shivamogga, and Kalaburagi 

Ratha with Kannada Jyothi has been touring Karnataka ahead of the Mandya sahitya sammelana

LC gate at Jokatte and LC gates between Mangaluru Central and Kannur to be upgraded to EOLBs in a phased manner

Wearing many hats — ecologist, GIS expert, data scientist, and conservation technologist — allows for a view of the connections between different fields

Simulations in education, from earth-sun-moon system to antimicrobial resistance, enhance learning through interactive virtual experiences.

Tata Sons to partner with Singapore in semiconductor industry, showcasing Singapore’s significance in global semiconductor production

Starts his next venture Twiddles, a guilt-free indulgence healthy food brand targeted at the youth and athletes

A murder mystery with zero thrills

A refreshing vehicle for a director and an actor making their debuts