CKTIS / JavaScript
OscillatorNode — generador de ondas periódicas
OscillatorNode genera una onda periódica mono. Configura su forma y frecuencia, conecta su salida y programa cuándo empieza y se detiene.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new OscillatorNode(context, { type: "sine", frequency: 440, detune: 0 }); oscillator.connect(destination); oscillator.start(when); oscillator.stop(when);OscillatorNode es una fuente de la Web Audio API: no tiene entradas y su salida es mono. No forma parte de ECMAScript.
type permite elegir sine, square, sawtooth o triangle. setPeriodicWave() establece una onda personalizada y custom. frequency (440 Hz de forma predeterminada) y detune (0 cents) son objetos AudioParam; cambia su .value o programa su automatización. La fórmula frequency * 2 ** (detune / 1200) calcula la frecuencia con la desafinación aplicada, antes de limitarla. El oscilador limita ese valor al intervalo entre la frecuencia de Nyquist negativa y la positiva.
start(when) y stop(when) usan segundos en la línea de tiempo del contexto. No se puede reiniciar un nodo: crea otro. El ejemplo se procesa sin conexión y sin sonido; comprueba que la API esté disponible en el navegador de destino.
Ejemplos
(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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.