Neatly Positioned Magazines


    0.1.7 • Public • Published


    Build Status

    allen is a collection of utilities for the Web Audio API. As of right now, mostly type checking different objects to determine what kind of type of node an object is, but if you find yourself reusing the same methods when developing with the Web Audio API, please add them!


    Install via npm, bower or component(1)

    npm install allen
    component install jsantell/allen



    Creates and returns an available AudioContext for the environment. If this method was called previously, or an AudioContext was set via setAudioContext(), then the same instance will be returned.

    setAudioContext( context )

    Sets the AudioContext to be returned from getAudioContext().

    isAudioContext( node )

    Returns true if node is an AudioContext; false otherwise.

    isAudioSource( node )

    Returns true if node inherits from an AudioSourceNode, like BufferSourceNode, MediaElementAudioSourceNode, MediaStreamAudioSourceNode or OscillatorNode; false otherwise.

    isAudioDestination( node )

    Returns true if node is an AudioDestinationNode; false otherwise.

    isAudioNode( node )

    Returns true if node inherits from AudioNode; false otherwise.

    isRegularAudioNode( node )

    Returns true if node inherits from AudioNode, and is not a source or destination node; false otherwise.

    isAudioParam( param )

    Returns true if param inherits from AudioParam; false otherwise.

    getBuffer( url, callback, [sendImmediately] )

    Sets up an XHR GET to the url, sets responseType to 'arraybuffer', and calls callback on load. If sendImmediately truthy, calls send() on the xhr object. Returns the xhr object. Used commonly with the Web Audio API.

    canPlayType( type )

    Checks if the browser can play audio of type. Strings accepted: 'ogg', 'mp3', 'wav', 'm4a'


        ctx = allen.getAudioContext(),
        src = ctx.createMediaElementSource( new Audio() ),
        gain = ctx.createGainNode();
      allen.isAudioNode( gain );  // true
      allen.isAudioNode( src );   // true
      allen.isAudioSource( src ); // true
      allen.isAudioSource( gain ); // false
      allen.isAudioParam( gain.gain ); // true


    Init and update git submodules and install grunt installed globally -- build src and specs and run tests with grunt, or fire off the watcher with grunt watch to build and test changes.

    Run tests with grunt mocha. In test/mocks/, there is a mock AudioContext object for running tests headlessly -- tests should pass in PhantomJS, as well as browsers.




    npm i allen

    DownloadsWeekly Downloads






    Last publish


    • jsantell