fix(analyser): expose additional methods and properties

Nickersoft · Nickersoft · commit 0584a13a54a5 · 2025-10-12T13:14:59.000-04:00
diff --git a/README.md b/README.md
@@ -84,7 +84,7 @@ function showVolume() {
 }
 
 function showWaveform() {
-  const frequencyData = monitor.frequencyData;
+  const frequencyData = monitor.byteTimeDomainData;
   // Some kind of drawing code...
   requestAnimationFrame(showWaveform);
 }
diff --git a/src/analyser.ts b/src/analyser.ts
@@ -1,6 +1,10 @@
 export class Analyser {
 	readonly node: AnalyserNode;
-	readonly #data: Uint8Array<ArrayBuffer>;
+
+	#byteFrequencyData: Uint8Array<ArrayBuffer>;
+	#byteTimeDomainData: Uint8Array<ArrayBuffer>;
+	#floatFrequencyData: Float32Array<ArrayBuffer>;
+	#floatTimeDomainData: Float32Array<ArrayBuffer>;
 
 	constructor(
 		readonly context: AudioContext = new AudioContext(),
@@ -36,22 +40,37 @@ export class Analyser {
 			this.node.channelCountMode = options.channelCountMode;
 		}
 
-		this.#data = new Uint8Array(this.node.frequencyBinCount);
+		this.#byteFrequencyData = new Uint8Array(this.node.frequencyBinCount);
+		this.#byteTimeDomainData = new Uint8Array(this.node.frequencyBinCount);
+		this.#floatFrequencyData = new Float32Array(this.node.frequencyBinCount);
+		this.#floatTimeDomainData = new Float32Array(this.node.frequencyBinCount);
 	}
 
-	/**
-	 * Returns the frequency data provided by the default analyzer
-	 */
-	get frequencyData(): Uint8Array {
-		this.node.getByteFrequencyData(this.#data);
-		return this.#data;
+	get byteFrequencyData(): Uint8Array {
+		this.node.getByteFrequencyData(this.#byteFrequencyData);
+		return this.#byteFrequencyData;
+	}
+
+	get floatFrequencyData(): Float32Array {
+		this.node.getFloatFrequencyData(this.#floatFrequencyData);
+		return this.#floatFrequencyData;
+	}
+
+	get byteTimeDomainData(): Uint8Array {
+		this.node.getByteTimeDomainData(this.#byteTimeDomainData);
+		return this.#byteTimeDomainData;
+	}
+
+	get floatTimeDomainData(): Float32Array {
+		this.node.getFloatTimeDomainData(this.#floatTimeDomainData);
+		return this.#floatTimeDomainData;
 	}
 
 	/**
 	 * Retrieves the current volume (average of amplitude^2)
 	 */
 	get volume(): number {
-		const data = this.frequencyData;
+		const data = this.byteFrequencyData;
 
 		let sum = 0;
 
@@ -62,6 +81,39 @@ export class Analyser {
 		return Math.sqrt(sum / data.length);
 	}
 
+	disconnect(): void;
+	disconnect(output: number): void;
+	disconnect(destinationNode: AudioNode): void;
+	disconnect(destinationNode: AudioNode, output: number): void;
+	disconnect(destinationNode: AudioNode, output: number, input: number): void;
+	disconnect(destinationParam: AudioParam): void;
+	disconnect(destinationParam: AudioParam, output: number): void;
+	disconnect(
+		destinationNodeOrParam?: AudioNode | AudioParam | number,
+		output?: number,
+		input?: number,
+	): void {
+		if (destinationNodeOrParam === undefined) {
+			this.node.disconnect();
+		} else if (typeof destinationNodeOrParam === "number") {
+			this.node.disconnect(destinationNodeOrParam);
+		} else if (destinationNodeOrParam instanceof AudioNode) {
+			if (output !== undefined && input !== undefined) {
+				this.node.disconnect(destinationNodeOrParam, output, input);
+			} else if (output !== undefined) {
+				this.node.disconnect(destinationNodeOrParam, output);
+			} else {
+				this.node.disconnect(destinationNodeOrParam);
+			}
+		} else if (destinationNodeOrParam instanceof AudioParam) {
+			if (output !== undefined) {
+				this.node.disconnect(destinationNodeOrParam, output);
+			} else {
+				this.node.disconnect(destinationNodeOrParam);
+			}
+		}
+	}
+
 	connectToDestination() {
 		this.node.connect(this.context.destination);
 	}
diff --git a/src/monitor.ts b/src/monitor.ts
@@ -9,6 +9,7 @@ export interface SetupAnalyzerArgs {
 
 export interface MonitorOptions {
 	context?: AudioContext;
+	analyserOptions?: AnalyserOptions;
 	setupAnalyser?: ((args: SetupAnalyzerArgs) => void) | false;
 }
 
@@ -27,7 +28,7 @@ export class Monitor {
 		this.context = this.#options.context ?? new AudioContext();
 		this.destination = this.context.destination;
 		this.source = this.context.createMediaStreamSource(this.stream);
-		this.analyser = new Analyser(this.context);
+		this.analyser = new Analyser(this.context, this.#options.analyserOptions);
 
 		if (options.setupAnalyser) {
 			options.setupAnalyser({
@@ -50,10 +51,31 @@ export class Monitor {
 	}
 
 	/**
-	 * Retrieves the current analyzer's frequency data
+	 * Retrieves the current analyzer's frequency data as an Uint8Array
 	 */
-	get frequencyData() {
-		return this.analyser.frequencyData;
+	get byteFrequencyData(): Uint8Array {
+		return this.analyser.byteFrequencyData;
+	}
+
+	/**
+	 * Retrieves the current analyzer's frequency data as an Float32Array
+	 */
+	get floatFrequencyData(): Float32Array {
+		return this.analyser.floatFrequencyData;
+	}
+
+	/**
+	 * Retrieves the current analyzer's time domain data as an Uint8Array
+	 */
+	get byteTimeDomainData(): Uint8Array {
+		return this.analyser.byteTimeDomainData;
+	}
+
+	/**
+	 * Retrieves the current analyzer's time domain data as an Float32Array
+	 */
+	get floatTimeDomainData(): Float32Array {
+		return this.analyser.floatTimeDomainData;
 	}
 
 	/**
diff --git a/tests/analyser.spec.js b/tests/analyser.spec.js
@@ -131,7 +131,7 @@ test.describe("Analyser", () => {
 			// Allow some time for audio processing
 			await new Promise((resolve) => setTimeout(resolve, 100));
 
-			const frequencyData = analyser.frequencyData;
+			const frequencyData = analyser.byteFrequencyData;
 
 			return {
 				isUint8Array: frequencyData instanceof Uint8Array,
@@ -325,7 +325,7 @@ test.describe("Monitor with Default Analyser", () => {
 			// Allow some time for audio processing
 			await new Promise((resolve) => setTimeout(resolve, 100));
 
-			const frequencyData = monitor.frequencyData;
+			const frequencyData = monitor.byteFrequencyData;
 
 			return {
 				isUint8Array: frequencyData instanceof Uint8Array,
@@ -417,8 +417,8 @@ test.describe("Monitor with Default Analyser", () => {
 
 			// Get multiple frequency data readings
 			await new Promise((resolve) => setTimeout(resolve, 100));
-			const data1 = monitor.frequencyData;
-			const data2 = monitor.frequencyData;
+			const data1 = monitor.byteFrequencyData;
+			const data2 = monitor.byteFrequencyData;
 
 			return {
 				sameLength: data1.length === data2.length,
diff --git a/tests/edge-cases.spec.js b/tests/edge-cases.spec.js
@@ -21,7 +21,7 @@ test.describe("Edge Cases", () => {
 
 			await new Promise((resolve) => setTimeout(resolve, 10));
 
-			const frequencyData = analyser.frequencyData;
+			const frequencyData = analyser.byteFrequencyData;
 			const volume = analyser.volume;
 
 			return {
@@ -54,15 +54,15 @@ test.describe("Edge Cases", () => {
 			await new Promise((resolve) => setTimeout(resolve, 100));
 
 			const volume1 = analyser.volume;
-			const frequencyData1 = analyser.frequencyData;
+			const frequencyData1 = analyser.byteFrequencyData;
 
 			// Resume the context
 			await context.resume();
 
 			await new Promise((resolve) => setTimeout(resolve, 100));
 
 			const volume2 = analyser.volume;
-			const frequencyData2 = analyser.frequencyData;
+			const frequencyData2 = analyser.byteFrequencyData;
 
 			stream.getTracks().forEach((track) => {
 				track.stop();
@@ -98,7 +98,7 @@ test.describe("Edge Cases", () => {
 					success: true,
 					fftSize: analyser.node.fftSize,
 					frequencyBinCount: analyser.node.frequencyBinCount,
-					frequencyDataLength: analyser.frequencyData.length,
+					frequencyDataLength: analyser.byteFrequencyData.length,
 				};
 			} catch (error) {
 				return {
@@ -129,7 +129,7 @@ test.describe("Edge Cases", () => {
 					success: true,
 					fftSize: analyser.node.fftSize,
 					frequencyBinCount: analyser.node.frequencyBinCount,
-					frequencyDataLength: analyser.frequencyData.length,
+					frequencyDataLength: analyser.byteFrequencyData.length,
 				};
 			} catch (error) {
 				return {
@@ -178,7 +178,7 @@ test.describe("Edge Cases", () => {
 			await new Promise((resolve) => setTimeout(resolve, 200));
 
 			const volume = analyser.volume;
-			const frequencyData = analyser.frequencyData;
+			const frequencyData = analyser.byteFrequencyData;
 
 			stream.getTracks().forEach((track) => {
 				track.stop();
@@ -270,7 +270,7 @@ test.describe("Edge Cases", () => {
 			await new Promise((resolve) => setTimeout(resolve, 200));
 
 			const volume = analyser.volume;
-			const frequencyData = analyser.frequencyData;
+			const frequencyData = analyser.byteFrequencyData;
 
 			stream1.getTracks().forEach((track) => {
 				track.stop();
diff --git a/tests/integration.spec.js b/tests/integration.spec.js
@@ -22,8 +22,8 @@ test.describe("Integration Tests", () => {
 
 			const monitorVolume = monitor.volume;
 			const recorderVolume = recorder.volume;
-			const monitorFreqData = monitor.frequencyData;
-			const recorderFreqData = recorder.frequencyData;
+			const monitorFreqData = monitor.byteFrequencyData;
+			const recorderFreqData = recorder.byteFrequencyData;
 
 			const blob = await recorder.stop();
 
@@ -524,7 +524,7 @@ test.describe("Resource Management Tests", () => {
 						await new Promise((resolve) => setTimeout(resolve, 200));
 
 						const volume = monitor.volume;
-						const frequencyData = monitor.frequencyData;
+						const frequencyData = monitor.byteFrequencyData;
 						const blob = await recorder.stop();
 
 						stream.getTracks().forEach((track) => {

Original file line number	Diff line number	Diff line change
`@@ -84,7 +84,7 @@ function showVolume() {`
`84`	`84`	`}`
`85`	`85`
`86`	`86`	`function showWaveform() {`
`87`		`- const frequencyData = monitor.frequencyData;`
	`87`	`+ const frequencyData = monitor.byteTimeDomainData;`
`88`	`88`	`// Some kind of drawing code...`
`89`	`89`	`requestAnimationFrame(showWaveform);`
`90`	`90`	`}`