Tone.js/test/core/AudioNode.js

define(["helper/Test", "Tone/core/Tone", "Tone/core/AudioNode", "helper/PassAudio", "Tone/core/Gain",
	"Tone/source/Oscillator", "Tone/component/Merge", "Tone/component/Split",
	"Tone/component/Filter", "helper/Offline", "Tone/signal/Signal", "helper/Supports", "helper/StereoSignal"],
function(Test, Tone, AudioNode, PassAudio, Gain, Oscillator, Merge,
	Split, Filter, Offline, Signal, Supports, StereoSignal){

	describe("AudioNode", function(){

		it("can be created and disposed", function(){
			var node = new AudioNode();
			node.dispose();
			Test.wasDisposed(node);
		});

		it("handles input and output connections", function(){
			var node = new AudioNode();
			node.createInsOuts(1, 1);
			node.connect(Test);
			Test.connect(node);
			node.dispose();
		});

		if (Supports.AUDIO_CONTEXT_CLOSE_RESOLVES){
			it("can be constructed with an options object", function(){
				var context = new AudioContext();
				var node = new AudioNode({
					"context" : context,
				});
				expect(node.context).to.be.equal(context);
				node.dispose();
				return context.close();
			});
		}

		it("reports its inputs and outputs", function(){
			var node0 = new AudioNode();
			node0.createInsOuts(3, 2);
			expect(node0.numberOfInputs).to.equal(3);
			expect(node0.numberOfOutputs).to.equal(2);
			node0.dispose();

			var node1 = new AudioNode();
			node1.createInsOuts(0, 1);
			expect(node1.numberOfInputs).to.equal(0);
			expect(node1.numberOfOutputs).to.equal(1);
			node1.dispose();

			var node2 = new AudioNode();
			node2.createInsOuts(1, 0);
			expect(node2.numberOfInputs).to.equal(1);
			expect(node2.numberOfOutputs).to.equal(0);
			node2.dispose();
		});

		it("is able to get and set the channelCount, channelCountMode and channelInterpretation", function(){
			var node0 = new AudioNode();
			node0.createInsOuts(1, 1);
			expect(node0.channelCount).to.equal(2);
			node0.channelCount = 1;
			expect(node0.channelCount).to.equal(1);
			node0.dispose();

			var node1 = new AudioNode();
			node1.createInsOuts(1, 1);
			expect(node1.channelCountMode).to.equal("max");
			node1.channelCountMode = "explicit";
			expect(node1.channelCountMode).to.equal("explicit");
			node1.dispose();

			var node2 = new AudioNode();
			node2.createInsOuts(1, 1);
			expect(node2.channelInterpretation).to.equal("speakers");
			node2.channelInterpretation = "discrete";
			expect(node2.channelInterpretation).to.equal("discrete");
			node2.dispose();
		});

		context("connections", function(){

			if (Supports.NODE_DISCONNECT){

				it("can disconnect with args", function(){
					var nodeA = Tone.context.createGain();
					var nodeB = Tone.context.createGain();
					nodeA.connect(nodeB, 0, 0);
					nodeA.disconnect(nodeB, 0, 0);
				});

				it("Tone nodes can disconnect with args", function(){
					var osc = new Oscillator();
					var gain = Tone.context.createGain();
					osc.connect(gain, 0, 0);
					osc.disconnect(gain, 0, 0);
					osc.dispose();
				});

				it("Tone nodes can disconnect from other Tone nodes with args", function(){
					var osc = new Oscillator();
					var filter = new Filter();
					osc.connect(filter, 0, 0);
					osc.disconnect(filter, 0, 0);
					osc.dispose();
				});

				it("can disconnect from a specific connection", function(){
					return PassAudio(function(input){
						var node = new Gain().toMaster();
						input.connect(node);
						input.disconnect(node);
					}).then(function(){
						return false;
					}).catch(function(){
						return true;
					});
				});

				it("can disconnect from a specific note and connection number", function(){
					return Offline(function(){
						var merge = new Merge().toMaster();
						var sig = new Signal(2).connect(merge, 0, 0);
						sig.connect(merge, 0, 1);
						sig.disconnect(merge, 0, 0);
					}, 0.05, 2).then(function(buffer){
						buffer.forEach(function(l, r){
							expect(l).to.equal(0);
							expect(r).to.equal(2);
						});
					});
				});

				it("can disconnect based on output number", function(){
					return Offline(function(){
						var merge = new Merge().toMaster();
						var split = new Split().connect(merge, 0, 0);
						split.connect(merge, 1, 1);
						var sig = new Signal(3).connect(split);
						split.disconnect(1);
					}, 0.05, 2).then(function(buffer){
						buffer.forEach(function(l, r){
							expect(l).to.equal(3);
							expect(r).to.equal(0);
						});
					});
				});

				it("can disconnect based on node name and output number", function(){
					return Offline(function(){
						var merge = new Merge().toMaster();
						var split = new Split().connect(merge, 0, 0);
						split.connect(merge, 1, 1);
						var sig = StereoSignal(3, 3).connect(split);
						split.disconnect(merge, 0, 0);
					}, 0.05, 2).then(function(buffer){
						buffer.forEach(function(l, r){
							expect(l).to.equal(0);
							expect(r).to.equal(3);
						});
					});
				});
			}

			it("connects two nodes", function(){
				return PassAudio(function(input){
					var node = new Gain().toMaster();
					input.connect(node);
				});
			});

			it("'connect' returns the node connecting to", function(){
				var nodeA = Tone.context.createGain();
				var nodeB = Tone.context.createGain();
				expect(nodeA.connect(nodeB)).to.equal(nodeB);
			});

			it("can chain connections", function(){
				return PassAudio(function(input){
					var node0 = new Gain();
					var node1 = new Gain().toMaster();
					input.chain(node0, node1);
				});
			});

			it("can fan connections", function(){
				return PassAudio(function(input){
					var node0 = new Gain().toMaster();
					var node1 = new Gain().toMaster();
					input.fan(node0, node1);
				});
			});
		});

	});
});