The HTMLMediaElement.preservesPitch
property determines whether or not the browser should adjust the pitch of the audio to compensate for changes to the playback rate made by setting HTMLMediaElement.playbackRate
.
HTMLMediaElement.preservesPitch
Value
A boolean value defaulting to true
.
Examples
Setting the preservesPitch property
In this example, we have an <audio>
element, a range control that adjusts the playback rate, and a checkbox that sets preservesPitch
.
Try playing the audio, then adjusting the playback rate, then enabling and disabling the checkbox.
<audio controls src="https://mdn.github.io/webaudio-examples/audio-basics/outfoxing.mp3"></audio> <div> <label for="rate">Adjust playback rate:</label> <input id="rate" type="range" min="0.25" max="3" step="0.05" value="1"> </div> <div> <label for="pitch">Preserve pitch:</label> <input type="checkbox" id="pitch" name="pitch" checked> </div>
const audio = document.querySelector("audio"); const rate = document.querySelector('#rate'); rate.addEventListener('input', () => audio.playbackRate = rate.value ); const pitch = document.querySelector('#pitch'); pitch.addEventListener('change', () => { audio.mozPreservesPitch = pitch.checked; audio.preservesPitch = pitch.checked; });
Specifications
Specification |
---|
HTML Standard # dom-media-preservespitch-dev |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
preservesPitch |
86
|
86
|
20
See
bug 1652950.
|
No
|
72
|
4
See
bug 214922.
|
86
|
86
|
20
See
bug 1652950.
|
61
|
4
See
bug 214922.
|
14.0
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/preservesPitch