Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes