CKTIS / JavaScript
OscillatorNode — gerador de formas de onda periódicas
OscillatorNode gera uma forma de onda periódica mono. Configura a forma e a frequência, liga a saída e agenda o início e a paragem.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new OscillatorNode(context, { type: "sine", frequency: 440, detune: 0 }); oscillator.connect(destination); oscillator.start(when); oscillator.stop(when);OscillatorNode é uma fonte da Web Audio API: não tem entradas e tem uma saída mono. Não faz parte de ECMAScript.
type permite escolher sine, square, sawtooth ou triangle. setPeriodicWave() define uma forma de onda personalizada e custom. frequency (440 Hz por predefinição) e detune (0 cents) são objetos AudioParam; altera o respetivo .value ou agenda a automatização. A fórmula frequency * 2 ** (detune / 1200) calcula a frequência com a desafinação aplicada, antes de a limitar. O oscilador limita esse valor ao intervalo entre a frequência de Nyquist negativa e a positiva.
start(when) e stop(when) usam segundos na linha temporal do contexto. Não é possível reiniciar um nó — cria outro. O exemplo faz a renderização offline, sem som; confirma que a API está disponível no navegador de destino.
Exemplos
(async () => {
const context = new OfflineAudioContext(1, 4800, 48000);
const oscillator = new OscillatorNode(context, {
type: "sine",
frequency: 440
});
oscillator.connect(context.destination);
oscillator.start(0);
oscillator.stop(0.1);
const buffer = await context.startRendering();
console.log(buffer.numberOfChannels, buffer.length);
})();Resultado
1 4800
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.