Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

OscillatorNode — générateur de forme d’onde périodique

OscillatorNode génère une forme d’onde périodique mono. Configurez sa forme et sa fréquence, connectez sa sortie, puis planifiez son démarrage et son arrêt.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new OscillatorNode(context, { type: "sine", frequency: 440, detune: 0 }); oscillator.connect(destination); oscillator.start(when); oscillator.stop(when);

OscillatorNode est une source de la Web Audio API : elle n’a aucune entrée et possède une sortie mono. Elle ne fait pas partie d’ECMAScript.

type permet de choisir sine, square, sawtooth ou triangle. setPeriodicWave() définit une forme d’onde personnalisée et custom. frequency (440 Hz par défaut) et detune (0 cent) sont des objets AudioParam ; modifiez leur .value ou planifiez leur automatisation. La formule frequency * 2 ** (detune / 1200) donne la fréquence après désaccordage, avant l’application des bornes. L’oscillateur ramène cette valeur, si nécessaire, dans l’intervalle compris entre l’opposé de la fréquence de Nyquist et la fréquence de Nyquist.

start(when) et stop(when) utilisent des secondes sur la ligne temporelle du contexte. Un nœud ne peut pas être redémarré : créez-en un autre. L’exemple effectue un rendu hors ligne, sans son ; vérifiez que l’API est disponible dans le navigateur cible.

Exemples

(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);
})();

Résultat

1 4800

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources