Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes